Cdrdao - Write audio CD-Rs in disk-at-once mode
===============================================================================

This file contains some additional information. See the manual page for usage
of the tool.

Please use the write simulation mode (command 'simulate') when trying this
program the first time on your system. This will detect problems or
incompatibilities without wasting a CD-recordable. Note that you may have to
eject and reinsert the CD-R after simulation before a real write can start.


Supported Devices
-----------------
Currently only the Philips CDD2600 CD writer is supported. It is possible that
other Philips writers will work, too. I'm interested in response about that.
You will have to use the option '--driver cdd2600' to force using the CDD2600
driver with other CD writers.

There is a driver for Plextor CD readers that can be used to read out the disc
toc including pre-gaps (command 'read-toc'). The CDD2600 driver cannot detect
pre-gaps, yet.


Pre-compiled Binaries
--------------------
The pre-compiled binaries should work with 2.0.x and 2.1.x kernels (tested
with kernel 2.0.33 and 2.1.111). Older kernels may require recompilation
because of a different maximum message size of the generic SCSI device.


Generic SCSI Device
-------------------
Cdrdao uses the generic SCSI device ('/dev/sg?') to access the CD writer.
Try 'cat /proc/devices' to check out if your kernel supports the character
device 'sg'. If not insert the corresponding module ('insmod sg.o') or 
reconfigure and compile the kernel. Cdrdao opens '/dev/cdrecorder' by default
which should be a link to the appropriate generic SCSI device.


Example for copying an audio CD:
--------------------------------
1. Create a toc-file for the source CD:

        cdrdao read-toc cd.toc

2. Read out the audio data to a single file (e.g. with cdda2wav):

        cdda2wav -t 1 -d 4500 data.wav

3. Write the CD:

        cdrdao write cd.toc


Example for composing an audio CD:
----------------------------------
Assume three existing audio files 'audio1.wav', 'audio2.wav' and 'audio3.wav'
that go in three tracks. We do not want a pause between track 1 and 2 (no
pre-gap). The first 10 seconds of 'audio1.wav' should be used as pre-gap for
track 3. Here is the toc-file:


// Track 1
TRACK AUDIO
FILE "audio1.wav" 0  // take all audio data from 'audio1.wav', length is taken
                     // from file

// Track 2
TRACK AUDIO
FILE "audio2.wav" 0  // take all audio data from 'audio2.wav', length is taken
                     // from file, no pre-gap

// Track 3
TRACK AUDIO
FILE "audio1.wav" 0 0:10:0 // take first 10 seconds from 'audio1.wav'
START                      // everything before this line goes into the pre-gap
FILE "audio3.wav" 0  // take all audio data from 'audio3.wav', length is taken
                     // from file


Type 'cdrdao show-toc example.toc' to check for the correct syntax of the
toc-file. Note that even for the command 'show-toc' the audio files must exist
if the length of the audio files is not specified like in the example.

Type 'cdrdao read-test example.toc' to check if all audio files can be read
without error (optional).

Type 'cdrdao simulate example.toc' to perform a write simulation (optional).

Type 'cdrdao write example.toc' to create the audio CD.


Contact
-------
Please report bugs and suggestions to 
Andreas Mueller <mueller@daneb.ping.de>
