BURN - Burn until recorded now!
-------------------------------

What it is
----------

Burn is a simple program/script written in Python.

It's aim is to make it simple and quick to burn CDs.

First of all Burn...

 * ... has to be a command line program/script;
 * ... must perform any of its feature invoking it only 
   once and with one and only one command line.

Burn should be able to:

 * create Audio CD from .ogg, .mp3, .wav (even toghether)
 * copy CDs
 * ceate Data-CD (storage, backups, etc.)
 * create a CD from an existing ISO image.

Burn still performs above features. Other things burn does:

 * size of stuff to be burned.
 * compute if there is enough free space for temporary files (images and audio files).
 * warns if size is bigger than CD capacity
 * asks if you want to see what is going to be burned (mounts and umounts images)
 * asks if you want to make other copies
 * shows main id3 tags for .mp3 and .ogg files

Requirements
------------

In order to work, burn requires python (v.2.3), cdrecord,
mkisofs, cdrdao, eyeD3 (http://www.travisshirk.net/eyeD3/releases/),
pyogg (python-pyvorbis) http://www.andrewchatham.com/pyogg/
(generic Ogg Vorbis modules for Python).
Optionally: you can choose not to decode mp3 and ogg files
with native burn functions choosing to do it with external decoders. If
you wanto to do so, you have to install preferred decoders (lame, ogg123, mpg321,
mpg123, etc.) and set up burn.conf.

Syntax
------

 First of all, remember following points: 

    1.  first argument has to be one of the burn modes:
           -A for Audio-CD
           -D for Data-CD
           -I for ISO-CD
           -C for Copy-CD
    2. you can test burn commands using -s option, which always perform 
       a CD writing simulation. So you don't have to waste CDs to test it. 

Quick start examples
--------------------

 Here are some commands that help you start using burn quickly:
  
 # burn -D -p /etc/ 
   Creates a CD with /etc/ contents.
   (you will find files and directories contained in /etc in CD's root.)

 # burn -D -p /home/bigpaul/video/summer_2003/spain.tar.gz

   Creates a CD with spain.tar.gz in CD's root

 # burn -D -r /etc/ 

   Creates a CD containing the whole /etc/ directory. (-r preserves path)

 # burn -D -n /mail_2003 /home/bigpaul/Mail -p /boot/vmli* 

   Creates a CD containing the whole /home/bigpaul/Mail renamed into /mail_2003. 
   (-n changes path name). This command also adds in CD's root every 
   vmli* file in /boot/ directory

 # burn -I -n image.iso

   Burns image.iso

 # burn -C

   Copy CDs (disk at once).

 # burn -A -a *.wav
 
   Creates an Audio CD. Tracks come from wav files

 # burn -A -a *.mp3

   Creates an Audio CD. Tracks come from mp3 files

 # burn -A -a *.ogg

   Creates an Audio CD. Tracks come from Ogg Vorbis files

 # burn -A -a *.mp3 file.ogg track01.wav

   Creates an Audio CD. Tracks come from .wav, .ogg, .mp3 files

