ABCDE
=====
abcde is a frontend command-line utility (actually, a shell script) that
grabs tracks off a CD, encodes them to mp3 format, and tags them, all in
one go.

Your finished MP3's are stored in a subdirectory of the current directory
(named after the artist) with a filename based on the track title. Spaces
are replaced by underscores, and apostrophes and control codes are filtered
out. The end result usually looks like: Metallica/Dont_Tread_On_Me.mp3
This filename munging is customizable - edit the mungefilename function in
your abcde.conf to change it.

Need to go through an HTTP proxy for CDDB access? No problem, just export
your http_proxy variable first so wget can see it.

Low on disk space? abcde has different algorithms to schedule ripping and
encoding - you can optimize for speed and disc read completion (-l 1, the
default), or for disk conservation (-l 2).

abcde can also take advantage of SMP systems, just like make. Try
'abcde -j 2' - it'll run two encoder processes while it rips the next
track.

Frustrated that you can't use the CPU power on Machine A sitting right
next to Machine B with the fast cdrom drive? Now you don't have to be -
Run distmp3host (included in distmp3) on Machine A, and then run
abcde -r MachineA from Machine B (where "MachineA" is a dns name or IP
address).

abcde requires the following backend tools to work:

* An MP3 encoder (lame, gogo, bladeenc, l3enc, etc). abcde defaults to using
  lame. To change this, edit /etc/abcde.conf, and uncomment and change
  the ENCODERSYNTAX line. Any MP3 encoder that takes two filenames on the
  command line, one for input, one for output, will work.
  You can get lame at: http://www.sulaco.org/mp3/
  You can get gogo at: http://homepage1.nifty.com/herumi/gogo_e.html
  You can get BladeEnc at: http://bladeenc.mp3.no/
  You can get a trial version of mp3enc at:
    http://www.iis.fhg.de/amm/download/mp3enc/index.html
* CD Paranoia, an audio CD reading utility,
* Or cdda2wav, the audio CD reading utility cdparanoia was born from.
* cd-discid, a CDDB DiscID reading program. Formerly bundled with abcde.
  It's available in Debian or at http://frantica.lly.org/~rcw/cd-discid/.
* wget, an HTTP retrieval program.
* id3, an id3 tagging program. Available at: http://frantica.lly.org/~rcw/id3/
* (optional) distmp3, a client/server for distributed mp3 encoding.
  You can get distmp3 at http://wlug.westbo.se/medlprog/medlprog.html

Potential problems:

Having trouble getting cdparanoia to read from your drive as a user?
Add yourself to the cdrom group, change the permissions on your cdrom device
to 660, and if you have a SCSI cdrom drive, check the permissions on
/dev/sg* as well.

Running out of disk space for .wav files but don't want to use -l 2? Put them
in a different location by adding WAVOUTPUTDIR=/some/other/path to your
/etc/abcde.conf or ~/.abcde.conf.

Abcde now has a mailing list - abcde@whimsica.lly.org. All new releases
will be announced there, and Debian bug reports will soon be directed there.
You are encouraged to subscribe - my goal is to keep as much discussion
about issues in abcde public as possible and to encourage open feedback.
Archives of this list will be made publically available soon.

To subscribe, put "subscribe" in the subject or body of an email to
"abcde-request@whimsica.lly.org".
--
Robert Woodcock <rcw@debian.org>
