mp3burn for Debian
------------------

mp3burn is really a very simple script, but it's handy enough that I
thought it should be available as a package.

The script differs from the upstream version in a couple of ways:

   * it has support for .m3u playlist files

   * it has support for FLAC files

   * it tries to detect invalid/non-present MP3 and OGG files *before* 
     burning two seconds of silence to your CD-R... :)

   * it uses mpg321 by default for mp3s instead of mpg123 (because
     mpg123 is non-free).  Because mpg321 cannot handle sample rates 
     other than 44.1kHz, an option -M <mp3decoder> has been added.
     
   * it can use ogg123 for Ogg Vorbis files 
     (thanks to Peter Muir <iyhi@yahoo.com> for the excellent patch)
     Note that OGG files with sample rates other than 44.1kHz will
     sound slow/fast (normally 2x fast).  There's not much to do about
     this until ogginfo supports more options.

   * it tries to detect if "-swab" is needed and add it automatically
     (use -m to override this functionality, and please send me email
      so that I can update the script for platforms other than x86)

You can set cdrecord parameters via the ~/.mp3burnrc file or pass
parameters to cdrecord via the command line (-o).   You may also set
the value of $mp3decoder (instead of using -M on the command line) to
use a decoder other than mpg321.  The format for the .mp3burnrc file is
simply any valid Perl:

# comments allowed
$cdrecord_opts = "dev=0,3,0 speed=2 -v -swab";
# let's use a different mp3decoder because mpg321 can't handle sample
# rates other than 44.1kHz.  There is no need for the full path because
# mp3burn will `which $mp3decoder` before invoking it
$mp3decoder = "mpg123-oss";

Alternately, you can put info about your CDR[W] in /etc/cdrecord.conf
(which used to be /etc/default/cdrecord).  See the file and cdrecord
documentation for the syntax for that file.

Finally, you should consider running this program as root, since
cdrecord really likes to be run as root, and the default Debian
install of cdrecord will not be setuid.  If you get a screen full
of messages from cdrecord, this is probably the problem.

*** IMPORTANT *** 
mp3burn will hang with older versions of mpg321 (specifically, 
versions < 0.1.5.2) if you try to burn an mp3 that is mono encoded. 
If you're backporting this script to an older system and don't
want to also backport mpg321, you can install and use mpg123
(if you don't mind installing non-free software).

Finally, I am aware that mp3burn-0.1 is out (actually, has been out for
a while).  I'll be merging the new features from that release into this
package soon.

 -- tony mancill <tmancill@debian.org> - Sun, 10 Nov 2002 21:49:18 -0800
