1abcde(1)                    General Commands Manual                   abcde(1)
2
3
4

NAME

6       abcde  -  Grab  an  entire CD and compress it to Ogg/Vorbis, MP3, FLAC,
7       Ogg/Speex and/or MPP/MP+(Musepack) format.
8

SYNOPSIS

10       abcde [options] [tracks]
11

DESCRIPTION

13       Ordinarily, the process of grabbing the data off a CD and encoding  it,
14       then  tagging or commenting it, is very involved.  abcde is designed to
15       automate this. It will take an entire CD and convert  it  into  a  com‐
16       pressed  audio format - Ogg/Vorbis, MPEG Audio Layer III, Free Lossless
17       Audio Codec (FLAC), Ogg/Speex, MPP/MP+(Musepack) and/or M4A (AAC)  for‐
18       mat(s).  With one command, it will:
19
20       *      Do  a  CDDB  query over the Internet to look up your CD or use a
21              locally stored CDDB entry
22
23       *      Grab an audio track (or all the audio CD tracks) from your CD
24
25       *      Normalize the volume of the individual file (or the album  as  a
26              single unit)
27
28       *      Compress  to Ogg/Vorbis, MP3, FLAC, Ogg/Speex, MPP/MP+(Musepack)
29              and/or M4A format(s), all in one CD read
30
31       *      Comment or ID3/ID3v2 tag
32
33       *      Give an intelligible filename
34
35       *      Calculate replaygain values for  the  individual  file  (or  the
36              album as a single unit)
37
38       *      Delete the intermediate WAV file (or save it for later use)
39
40       *      Repeat until finished
41
42       Alternatively,  abcde can also grab a CD and turn it into a single FLAC
43       file with an embedded cuesheet which can be user later on as  a  source
44       for other formats, and will be treated as if it was the original CD. In
45       a way, abcde can take a compressed backup of your CD collection.
46

OPTIONS

48       -1     Encode the whole CD in a single file. The  resulting  file  uses
49              the CD title for tagging. If the resulting format is a flac file
50              with an embedded cuesheet, the file can be used as a source  for
51              creating  other  formats.  Use  "-1  -o flac -a default,cue" for
52              obtaining such a file.
53
54       -a [actions]
55              Comma-delimited list of actions to perform. Can be one  or  more
56              of:  cddb,  cue, read, normalize, encode, tag, move, replaygain,
57              playlist, clean. Normalize and encode imply  read.  Tag  implies
58              cddb,  read,  encode.  Move  implies  cddb,  read,  encode, tag.
59              Replaygain implies cddb, read, encode, tag and  move.   Playlist
60              implies  cddb. The default is to do all actions except cue, nor‐
61              malize, replaygain and playlist.
62
63       -b     Enable batch mode normalization. See the BATCHNORM configuration
64              variable.
65
66       -B     Disable  batch mode replaygain. It processes file by file to add
67              the replaygain information. See the NOBATCHREPLAYGAIN configura‐
68              tion variable.
69
70       -c [filename]
71              Specifies  an additional configuration file to parse. Configura‐
72              tion options in this file override those in  /etc/abcde.conf  or
73              $HOME/.abcde.conf.
74
75       -C [discid]
76              Allows  you  to  resume  a session for discid when you no longer
77              have the CD available (abcde will automatically  resume  if  you
78              still  have the CD in the drive). You must have already finished
79              at least the "read" action during the previous session.
80
81       -d [devicename | filename]
82              CD-ROM block device that  contains  audio  tracks  to  be  read.
83              Alternatively, a single-track flac file with embedded cuesheet.
84
85       -D     Capture  debugging  information  (you'll want to redirect this -
86              try 'abcde -D 2>logfile')
87
88       -e     Erase information about encoded tracks from the internal  status
89              file, to enable other encodings if the wav files have been kept.
90
91       -f     Force  the removal of the temporary ABCDETEMPDIR directory, even
92              when we have not finished. For example, one can read and  encode
93              several formats, including ´.ogg´, and later on execute a ´move´
94              action with only one of the given formats. On a normal situation
95              it  would erase the rest of those encoded formats. In this case,
96              abcde will refuse to execute such command, except if -f is used.
97
98       -g     Enable lame's --nogap option.  See the NOGAP variable.  WARNING:
99              lame's  --nogap disables the Xing mp3 tag.  This tag is required
100              for mp3 players to correctly display track lengths when  playing
101              variable-bit-rate mp3 files.
102
103       -h     Get help information.
104
105       -j [number]
106              Start  [number]  encoder  processes at once. Useful for SMP sys‐
107              tems. Overrides the MAXPROCS configuration variable. Set  it  to
108              "0" when using distmp3 to avoid local encoding processes.
109
110       -k     Keep the wav files after encoding.
111
112       -l     Use  the  low-diskspace algorithm. See the LOWDISK configuration
113              variable.
114
115       -L     Use a local CDDB repository. See CDDBLOCALDIR variable.
116
117       -n     Do not query CDDB database. Create and use a template. Edit  the
118              template to provide song names, artist(s), ...
119
120       -N     Non interactive mode. Do not ask anything from the user. Just go
121              ahead.
122
123       -m     Create DOS-style  playlists,  modifying  the  resulting  one  by
124              adding CRLF line endings. Some hardware players insist on having
125              those to work.
126
127       -o [filetype][:filetypeoptions]
128              Select output type. Can be "vorbis" (or "ogg"),  "mp3",  "flac",
129              "spx", "mpc", "m4a" or "wav".  Specify a comma-delimited list of
130              output types to obtain all specified types.  See the  OUTPUTTYPE
131              configuration  variable. One can pass options to the encoder for
132              a specific filetype on the command line separating them  with  a
133              colon. The options must be escaped with double-quotes.
134
135       -p     Pads track numbers with 0´s.
136
137       -P     Use  Unix PIPES to read and encode in one step. It disables mul‐
138              tiple encodings, since the WAV audio file is never stored in the
139              disc.
140
141       -q [quality]
142              Use  a  pre-defined  quality  level  for  the  encoding process.
143              Defined as low, medium or high. The "medium" value  is  used  to
144              reset  the  default  values  if  other  are  used  in the config
145              file(s).
146
147       -r [hosts...]
148              Remote encode on this comma-delimited  list  of  machines  using
149              distmp3. See the REMOTEHOSTS configuration variable.
150
151       -R     When  CDDBLOCALDIR  and  CDDBUSELOCAL are defined, search recur‐
152              sively under the defined  directory  for  matches  of  the  CDDB
153              entry.
154
155       -s [fields...]
156              List,  separated  by  commas, the fields to be shown in the CDDB
157              parsed entries.  Right now it only uses "year" and "genre".
158
159       -S [speed]
160              Set the speed of the CD drive. Needs CDSPEED and CDSPEEDOPTS set
161              properly  and both the program and device must support the capa‐
162              bility.
163
164       -t [number]
165              Start the numbering of the tracks at a  given  number.  It  only
166              affects the filenames and the playlist. Internal (tag) numbering
167              remains the same.
168
169       -T [number]
170              Same as -t but changes also the internal (tag)  numbering.  Keep
171              in  mind  that the default TRACK tag for MP3 is $T/$TRACKS so it
172              is changed to simply $T.
173
174       -U     Set CDDBPROTO to version 5,  so  that  we  retrieve  ISO-8859-15
175              encoded  CDDB  information,  and  we  tag  and add comments with
176              Latin1 encoding.
177
178       -v     Show the version and exit
179
180       -V     Be a bit more verbose. On slow networks the CDDB requests  might
181              give the sensation nothing is happening.
182
183       -x     Eject  the  CD  when  all tracks have been read. See the EJECTCD
184              configuration variable.
185
186       -X [cue2discid]
187              Use an alternative "cue2discid" implementation. The name of  the
188              binary  must be exactly that. abcde comes with an implementation
189              in python under the  examples  directory.  The  special  keyword
190              "builtin" forces the usage of the internal (default) implementa‐
191              tion in shell script.
192
193       -w [comment]
194              Add a comment to the tracks ripped from the CD.
195
196       -W [number]
197              Concatenate CD´s. It uses the number provided to define  a  com‐
198              ment  "CD #" and to modify the numbering of the tracks, starting
199              with "#01". For Ogg/Vorbis and FLAC files,  it  also  defines  a
200              DISCNUMBER tag.
201
202       -z     DEBUG mode: it will rip, using cdparanoia, the very first second
203              of each track  and  proceed  with  the  actions  requested  very
204              quickly,  also  providing  some  "hidden" information about what
205              happens on the background. CAUTION: IT WILL ERASE  ANY  EXISTING
206              RIPS WITHOUT WARNING!
207
208       [tracks]
209              A list of tracks you want abcde to process. If this isn't speci‐
210              fied, abcde will process the entire CD. Accepts ranges of  track
211              numbers  - "abcde 1-5 7 9" will process tracks 1, 2, 3, 4, 5, 7,
212              and 9.
213

OUTPUT

215       Each track is, by default, placed in a separate file  named  after  the
216       track in a subdirectory named after the artist under the current direc‐
217       tory.  This can be modified using the OUTPUTFORMAT  and  VAOUTPUTFORMAT
218       variables in your abcde.conf. Each file is given an extension identify‐
219       ing its compression  format,  'vorbis'  for  '.ogg',  '.mp3',  '.flac',
220       '.spx', '.mpc', '.aac' or '.wav'.
221

CONFIGURATION

223       abcde  sources two configuration files on startup - /etc/abcde.conf and
224       $HOME/.abcde.conf, in that order.
225
226       The configuration options stated on those files can  be  overridden  by
227       providing
228              the appropriate flags at runtime.
229
230       The configuration variables have to be set as follows:
231
232       VARIABLE=value
233              Except when "value" needs to be quoted or otherwise interpreted.
234              If other variables within "value" are to be expanded upon  read‐
235              ing  the  configuration file, then double quotes should be used.
236              If they are only supposed to be expanded upon use  (for  example
237              OUTPUTFORMAT) then single quotes must be used.
238
239       All sh escaping/quoting rules apply.
240
241       Here is a list of options abcde recognizes:
242
243       CDDBMETHOD
244              Specifies the method we want to use to retrieve the track infor‐
245              mation. Two values are recognized: "cddb" and "musicbrainz". The
246              "cddb" value needs the CDDBURL and HELLOINFO variables described
247              below. The "musicbrainz" value uses Python to establish  a  con‐
248              versation with the server for information retrieval.
249
250       CDDBURL
251              Specifies a server to use for CDDB lookups.
252
253       CDDBPROTO
254              Specifies  the  protocol  version used for the CDDB retrieval of
255              results. Version 6 retrieves CDDB entries in UTF-8 format.
256
257       HELLOINFO
258              Specifies the Hello information to send to the CDDB server.  The
259              CDDB protocol requires you to send a valid username and hostname
260              each time you connect. The format of this is username@hostname.
261
262       CDDBLOCALDIR
263              Specifies a directory where we store a  local  CDDB  repository.
264              The  entries  must  be  standard CDDB entries, with the filename
265              being the DISCID value. Other CD playing  and  ripping  programs
266              (like  Grip) store the entries under ~/.cddb and we can make use
267              of those entries.
268
269       CDDBLOCALRECURSIVE
270              Specifies if the CDDBLOCALDIR has  to  be  searched  recursively
271              trying  to  find a match for the CDDB entry. If a match is found
272              and selected, and CDDBCOPYLOCAL is selected, it will  be  copied
273              to the root of the CDDBLOCALDIR if CDDBLOCALPOLICY is "modified"
274              or "new".
275
276       CDDBLOCALPOLICY
277              Defines when a CDDB  entry  should  be  stored  in  the  defined
278              CDDBLOCALDIR.  The possible policies are: "net" for a CDDB entry
279              which has been received from the net (overwriting  any  possible
280              local  CDDB  entry);  "new"  for a CDDB entry which was received
281              from the net, but will request confirmation to overwrite a local
282              CDDB  entry  found  in  the  root of the CDDBLOCALDIR directory;
283              "modified" for a CDDB entry found in the  local  repository  but
284              which  has  been modified by the user; and "always" which forces
285              the CDDB entry to be stored back in the root of the CDDBLOCALDIR
286              no  matter  where it was found, and no matter it was not edited.
287              This last option will always overwrite the one found in the root
288              of the local repository (if any). STILL NOT WORKING!!
289
290       CDDBCOPYLOCAL
291              Store  local  copies of the CDDB entries under the $CDDBLOCALDIR
292              directory.
293
294       CDDBUSELOCAL
295              Actually use the stored copies of the CDDB entries. Can be over‐
296              ridden  using  the  "-L" flag (if is CDDBUSELOCAL in "n"). If an
297              entry is found, we always give the choice of retrieving  a  CDDB
298              entry from the internet.
299
300       SHOWCDDBFIELDS
301              Coma-separated  list  of fields we want to parse during the CDDB
302              parsing.  Defaults to "year,genre".
303
304       OGGENCODERSYNTAX
305              Specifies the  style  of  encoder  to  use  for  the  Ogg/Vorbis
306              encoder. Valid options are ´oggenc´ (default for Ogg/Vorbis) and
307              ´vorbize´.  This affects the default location of the binary, the
308              variable  to  pick  encoder command-line options from, and where
309              the options are given.
310
311       MP3ENCODERSYNTAX
312              Specifies the style of encoder to use for the MP3 encoder. Valid
313              options  are  ´lame´  (default  for  MP3),  ´gogo´,  ´bladeenc´,
314              ´l3enc´ and ´mp3enc´.  Affects the same way as  explained  above
315              for Ogg/Vorbis.
316
317       FLACENCODERSYNTAX
318              Specifies  the  style of encoder to use for the FLAC encoder. At
319              this point only ´flac´ is available for FLAC encoding.
320
321       SPEEXENCODERSYNTAX
322              Specifies the style of encoder to use for Speex encoder. At this
323              point only ´speexenc´ is available for Ogg/Speex encoding.
324
325       MPPENCODERSYNTAX
326              Specifies  the  style  of  encoder to use for MPP/MP+ (Musepack)
327              encoder. At this point we only  have  ´mppenc´  available,  from
328              corecodecs.org.
329
330       AACENCODERSYNTAX
331              Specifies  the style of encoder to use for M4A (AAC) encoder. At
332              this point we only support ´faac´, so ´default´ points to it.
333
334       NORMALIZERSYNTAX
335              Specifies the style of normalizer to  use.   Valid  options  are
336              ´default´  and  ´normalize' (and both run ´normalize´), since we
337              only support it, ATM.
338
339       CDROMREADERSYNTAX
340              Specifies the style of cdrom reader to use.  Valid  options  are
341              ´cdparanoia´,  ´debug´  and  ´flac´. It is used for querying the
342              CDROM and obtain a list of valid tracks  and  DATA  tracks.  The
343              special  ´flac´  case  is used to "rip" CD tracks from a single-
344              track flac file.
345
346       CUEREADERSYNTAX
347              Specifies the syntax of the program we use to read  the  CD  CUE
348              sheet.  Right  now  we  only  support ´mkcue´, but in the future
349              other readers might be used.
350
351       KEEPWAVS
352              It defaults to no, so if you want to keep those wavs ripped from
353              your  CD, set it to "y". You can use the "-k" switch in the com‐
354              mand line. The default behaviour with KEEPWAVS set  is  to  keep
355              the  temporary  directory  and  the  wav  files  even  you  have
356              requested the "clean" action.
357
358       PADTRACKS
359              If set to "y", it adds 0's to the file  numbers  to  complete  a
360              two-number holder. Useful when encoding tracks 1-9.
361
362       INTERACTIVE
363              Set  to  "n" if you want to perform automatic rips, without user
364              intervention.
365
366       NICE VALUES
367              Define the values for priorities (nice values) for the different
368              CPU-hungry  processes: encoding (ENCNICE), CDROM read (READNICE)
369              and distributed encoder with distmp3 (DISTMP3NICE).
370
371       PATHNAMES
372              The following configuration file options specify  the  pathnames
373              of  their  respective  utilities: LAME, TOOLAME, GOGO, BLADEENC,
374              L3ENC, XINGMP3ENC,  MP3ENC,  VORBIZE,  OGGENC,  FLAC,  SPEEXENC,
375              MPPENC,   AACEND,   ID3,  ID3V2,  EYED3,  METAFLAC,  CDPARANOIA,
376              CDDA2WAV, CDDAFS, CDDISCID, CDDBTOOL,  EJECT,  MD5SUM,  DISTMP3,
377              VORBISCOMMENT, NORMALIZE, CDSPEED, MP3GAIN, VORBISGAIN, MPPGAIN,
378              MKCUE, MKTOC, CUE2DISCID (see option "-X"), DIFF and HTTPGET.
379
380       COMMAND-LINE OPTIONS
381              If you wish to specify command-line options to any of  the  pro‐
382              grams  abcde uses, set the following configuration file options:
383              LAMEOPTS,  TOOLAMEOPTS,   GOGOOPTS,   BLADEENCOPTS,   L3ENCOPTS,
384              XINGMP3ENCOPTS,  MP3ENCOPTS,  VORBIZEOPTS, OGGENCOPTS, FLACOPTS,
385              SPEEXENCOPTS,  MPPENCOPTS,   AACENCOPTS,   ID3OPTS,   ID3V2OPTS,
386              MP3GAINOPTS,     CDPARANOIAOPTS,    CDDA2WAVOPTS,    CDDAFSOPTS,
387              CDDBTOOLOPTS,     EJECTOPTS,     DISTMP3OPTS,     NORMALIZEOPTS,
388              CDSPEEDOPTS,  MKCUEOPTS,  VORBISCOMMMENTOPTS, METAFLACOPTS, DIF‐
389              FOPTS, FLACGAINOPTS, VORBISGAINOPTS and HTTPGETOPTS.
390
391       CDSPEEDVALUE
392              Set the value of the CDROM speed. The default  is  to  read  the
393              disc  as fast as the reading program and the system permits. The
394              steps are defined as 150kB/s (1x).
395
396       ACTIONS
397              The default actions to be performed when reading a disc.
398
399       CDROM  If set, it points to the CD-Rom device which has to be used  for
400              audio  extraction. Abcde tries to guess the right device, but it
401              may fail. The special ´flac´ option is defined to extract tracks
402              from a single-track flac file.
403
404       CDPARANOIACDROMBUS
405              Defined  as "d" when using cdparanoia with an IDE bus and as "g"
406              when using cdparanoia with the ide-scsi emulation layer.
407
408       OUTPUTDIR
409              Specifies the directory to place completed tracks/playlists in.
410
411       WAVOUTPUTDIR
412              Specifies the temporary directory to store .wav files in.  Abcde
413              may  use  up  to  700MB  of  temporary  space  for  each session
414              (although it is rare to use over 100MB for a  machine  that  can
415              encode music as fast as it can read it).
416
417       OUTPUTTYPE
418              Specifies  the encoding format to output, as well as the default
419              extension and encoder. Defaults to "vorbis". Valid settings  are
420              "vorbis"  (or  "ogg")  (Ogg/Vorbis),  "mp3"  (MPEG-1 Audio Layer
421              III), "flac" (Free Lossless  Audio  Codec),  "spx"  (Ogg/Speex),
422              "mpc"  (MPP/MP+ (Musepack)), "m4a" (for M4A (AAC)) or "wav" (Mi‐
423              crosoft Waveform). Values like "vorbis,mp3" encode the tracks in
424              both Ogg/Vorbis and MP3 formats. For example
425              OUTPUTTYPE=vorbis,flac
426              For  each value in OUTPUTTYPE, abcde expands a different process
427              for encoding, tagging and moving, so  you  can  use  the  format
428              placeholder,  OUTPUT, to create different subdirectories to hold
429              the different types.  The  variable  OUTPUT  will  be  'vorbis',
430              'mp3',  'flac',  'spx',  'mpc', 'm4a' and/or 'wav', depending on
431              the OUTPUTTYPE you define. For example
432              OUTPUTFORMAT='${OUTPUT}/${ARTISTFILE}/${ALBUMFILE}/${TRACK‐
433              NUM}._${TRACKFILE}'
434
435       OUTPUTFORMAT
436              Specifies  the  format  for  completed  Ogg/Vorbis,  MP3,  FLAC,
437              Ogg/Speex, MPP/MP+ (Musepack) or M4A  filenames.  Variables  are
438              included  using  standard  shell  syntax.  Allowed variables are
439              GENRE, ALBUMFILE, ARTISTFILE,  TRACKFILE,  TRACKNUM,  and  YEAR.
440              Default    is   ´${ARTISTFILE}-${ALBUMFILE}/${TRACKNUM}-${TRACK‐
441              FILE}´.  Make sure to use single quotes  around  this  variable.
442              TRACKNUM  is  automatically  zero-padded,  when  the  number  of
443              encoded tracks is higher than 9. When lower, you can force  with
444              '-p' in the command line.
445
446       VAOUTPUTFORMAT
447              Just  like  OUTPUTFORMAT  but  for  Various  Artists  discs. The
448              default      is      'Various-${ALBUMFILE}/${TRACKNUM}.${ARTIST‐
449              FILE}-${TRACKFILE}'
450
451       ONETRACKOUTPUTFORMAT
452              Just  like  OUTPUTFORMAT  but  for single-track rips (see option
453              "-1"). The default is '${ARTISTFILE}-${ALBUMFILE}/${ALBUMFILE}'
454
455       VAONETRACKOUTPUTFORMAT
456              Just like ONETRACKOUTPUTFORMAT but for  Various  Artists  discs.
457              The default is 'Various-${ALBUMFILE}/${ALBUMFILE}'
458
459       MAXPROCS
460              Defines  how  many  encoders to run at once. This makes for huge
461              speedups on SMP systems. You should run one encoder per  CPU  at
462              once  for  maximum  efficiency,  although more doesn't hurt very
463              much. Set it "0" when using mp3dist to  avoid  getting  encoding
464              processes in the local host.
465
466       LOWDISK
467              If set to y, conserves disk space by encoding tracks immediately
468              after reading them. This is  substantially  slower  than  normal
469              operation but requires several hundred MB less space to complete
470              the encoding of an entire CD. Use only if your system is low  on
471              space and cannot encode as quickly as it can read.
472
473              Note  that  this  option  may  also  help when reading a CD with
474              errors. This is because on a scratchy disk reading is quite tim‐
475              ing sensitive and this option reduces the background load on the
476              system which allows the ripping program more precise control.
477
478       BATCHNORM
479              If set to y, enables batch mode normalization,  which  preserves
480              relative  volume  differences  between  tracks of an album. Also
481              enables nogap encoding when using the ´lame´ encoder.
482
483       NOGAP  Activate the lame's --nogap option, that allows files  found  in
484              CDs  with no silence between songs (such as live concerts) to be
485              encoded without noticeable gaps. WARNING:  lame's  --nogap  dis‐
486              ables the Xing mp3 tag.  This tag is required for mp3 players to
487              correctly display track lengths when  playing  variable-bit-rate
488              mp3 files.
489
490       PLAYLISTFORMAT
491              Specifies  the  format  for  completed playlist filenames. Works
492              like  the  OUTPUTFORMAT  configuration  variable.   Default   is
493              ´${ARTISTFILE}_-_${ALBUMFILE}.m3u´.   Make  sure  to  use single
494              quotes around this variable.
495
496       PLAYLISTDATAPREFIX
497              Specifies a prefix for filenames within a playlist.  Useful  for
498              http playlists, etc.
499
500       DOSPLAYLIST
501              If  set,  the  resulting  playlist will have CR-LF line endings,
502              needed by some hardware-based players.
503
504       COMMENT
505              Specifies a comment to embed in the ID3 or Ogg comment field  of
506              each  finished  track. Can be up to 28 characters long. Supports
507              the same syntax as  OUTPUTFORMAT.  Does  not  currently  support
508              ID3v2.
509
510       REMOTEHOSTS
511              Specifies  a  comma-delimited  list of systems to use for remote
512              encoding using distmp3. Equivalent to -r.
513
514       mungefilename
515              mungefilename() is an abcde shell function that can be  overrid‐
516              den  via  abcde.conf.  It  takes CDDB data as $1 and outputs the
517              resulting filename on stdout.  It  defaults  to  eating  control
518              characters,  apostrophes  and question marks, translating spaces
519              and forward slashes to underscores, and translating colons to an
520              underscore and a hyphen.
521              If  you modify this function, it is probably a good idea to keep
522              the forward slash munging (UNIX cannot store a file with  a  '/'
523              char in it) as well as the control character munging (NULs can't
524              be in a filename either, and newlines and such in filenames  are
525              typically not desirable).
526
527       mungegenre
528              mungegenre  ()  is  a  shell  function used to modify the $GENRE
529              variable. As a default action, it takes $GENRE as $1 and outputs
530              the  resulting  value to stdout converting all UPPERCASE charac‐
531              ters to lowercase.
532
533       pre_read
534              pre_read () is a shell function which  is  executed  before  the
535              CDROM is read for the first time, during abcde execution. It can
536              be used to close the CDROM tray, to set its speed  (via  "setcd"
537              or via "eject", if available) and other preparation actions. The
538              default function is empty.
539
540       post_read
541              post_read () is a shell function which  is  executed  after  the
542              CDROM is read (and, if applies, before the CDROM is ejected). It
543              can be used to read a TOC from the CDROM, or to try to read  the
544              DATA  areas from the CD (if any exist).  The default function is
545              empty.
546
547       EJECTCD
548              If set to "y", abcde will call eject(1) to eject the cdrom  from
549              the drive after all tracks have been read. It has no effect when
550              CDROM is set to a flac file.
551
552       EXTRAVERBOSE
553              If set to "y", some operations which are usually  now  shown  to
554              the  end user are visible, such as CDDB queries. Useful for ini‐
555              tial debug and if your network/CDDB server is slow.
556

EXAMPLES

558       Possible ways one can call abcde
559
560       abcde  Will work in most systems
561
562       abcde -d /dev/cdrom2
563              If the CDROM you are reading from is not the standard /dev/cdrom
564              (in GNU/Linux systems)
565
566       abcde -o vorbis,flac
567              Will create both Ogg/Vorbis and Ogg/FLAC files.
568
569       abcde -o vorbis:"-b 192"
570              Will  pass "-b 192" to the Ogg/Vorbis encoder, without having to
571              modify the config file
572
573       abcde -W 1
574              For double+ CD settings: will create the 1st  CD  starting  with
575              the  track  number  101,  and  will  add a comment "CD 1" to the
576              tracks, the second starting with 201 and so on.
577
578       abcde -d singletrack.flac
579              Will extract the files contained in singletrack using the embed‐
580              ded cuesheet.
581

BACKEND TOOLS

583       abcde requires the following backend tools to work:
584
585       *      An  Ogg/Vorbis,  MP3,  FLAC, Ogg/Speex, MPP/MP+(Musepack) or M4A
586              encoder (oggenc, vorbize, lame, gogo, bladeenc,  l3enc,  mp3enc,
587              flac, speexenc, mppenc, faac)
588
589       *      An  audio  CD  reading  utility  (cdparanoia,  icedax, cdda2wav,
590              dagrab)
591
592       *      cd-discid, a CDDB DiscID reading program.
593
594       *      An HTTP retrieval program: wget, fetch (FreeBSD) or curl (Mac OS
595              X,  among  others). Alternatively, musicbrainz-get-tracks (which
596              depends on Python) can be  used  to  retrieve  CDDB  information
597              about the CD.
598
599       *      (for MP3s) id3 or id3v2, id3 v1 and v2 tagging programs.
600
601       *      (optional)  distmp3,  a client/server for distributed mp3 encod‐
602              ing.
603
604       *      (optional) normalize, a WAV file volume normalizer.
605
606       *      (optional)  a  replaygain  file  volume  modifier   (vorbisgain,
607              metaflac, mp3gain, replaygain),
608
609       *      (optional) mkcue, a CD cuesheet extractor.
610

SEE ALSO

612       cdparanoia(1),   icedax(1),   cdda2wav(1),   dagrab(1),   normalize(1),
613       oggenc(1), vorbize(1),  flac(1),  toolame(1),  speexenc(1),  mppenc(1),
614       faac(1), id3(1), id3v2(1), wget(1), fetch(1), cd-discid(1), distmp3(1),
615       distmp3host(1), curl(1), mkcue(1), vorbisgain(1), mp3gain(1)
616

AUTHORS

618       Robert Woodcock <rcw@debian.org>, Jesus Climent  <jesus.climent@hispal‐
619       inux.es> and contributions from many others.
620
621
622
623                                                                      abcde(1)
Impressum