
cdw is an ncurses-based CD writer program, which uses cdrecord and mkisofs.
Thanks to Sharad Mittal, who wrote CDrecorder! I learned threads and regex's
from his code!

Install
-------
Copy cdw-0.2.x.tar.gz to your source directory, such as /usr/local/src and
'untar' the archive. Complie and install! Type:
 
tar -xzf cdw-0.2.x.tar.gz
cd ./cdw-0.2.x
./configure
make
make install

The configure script will detect all packages that are needed or suggested
for cdw. The cdrecord and mkisofs are always needed for compiling. Without these
programs cdw is useless. Cdw can work together with the following
programs:
cdda2wav: to save audio CDs to wav files.
lame: for saving tracks directly to mp3 instead of wav.
oggenc: for saving tracks directly to Ogg Vorbis format.

Configure automatically detects these programs if they are available. You 
can also add the path of the programs to configure manually . For more information type:
'./configure --help'

The program automatically creates ~/.cdw.conf in your home directory. This
distribution package contains a default.conf file, which is a sample configuration.
The program automatically creates ~/.cdw directory, and makes symbolic links
from the selected files into this directory.

Install of GTK GUI
------------------
If you would like to use the GTK interface of cdw you must add --enable-gui
parameter for configure because cdw doesn't contain this feature in default.
Only the version 2 of GTK is supported. After you can use cdw in GTK 
interface if you start the program with cdw -g.


Program parameters
------------------
cdw accept the following parameters:
-v | --version : display the version number of cdw
-h | --help    : display help


Usage
-----
The menu:

Add files: Select files and directories for the cdimage. Press <space> to 
select a file || directory, or press <ESC> to quit dialog box.

Delete files: The select dialog is on the rigth side of the screen. If you 
want to delete files from the image, use this dialog. Press <DEL> to delete
a file, or press <ESC> to leave this dialog.

Create image: Create a cdimage to "Imagefile" file from selected files. See Options later.
		
Write image: If the "Write from image" is checked cdw will write the image to
the CD. If not checked, selected files are written direcly without image creation.
		
Blank CD-RW: Erase data from CD-RW (rewritable disc). In the options you can 
select the type of blank: fast or full.
		
Options: see later. 

Quit:    :)) Guess, what...

Options
-------
All options are associated with a key. You can modify the options by pressing the corresponding key.
You can leave the input fields with ENTER or press ESC to quit the field without saving.
    
General properties (1):
SCSI device: 
scsibus,target,lun. (For a SCSI-emulated IDE CDRW: 0,0,0) 

Speed: 
writing speed
     
Imagefile: 
reading/writing image from/to this file

CD-ROM: 
reading device (if you copy data CDs or creating CD images)

Logfile: 
mkisofs & cdrecord write logs to this file

Volume ID: 
adjust disc ID

Blank fast: 
'cdrecord -blank=fast || all' (fast blanking|| full erase)

Eject when done: 
eject cd tray when finished writing

Disk at once: 
fixate disk after writing.

Joliet information:
generate Joliet directory information 

Rock Ridge: 
generate Rock Ridge directory information

Dummy write: 
writing in dummy mode

Show log after write:
show the content of log after writing.

Auto show vol.:
show the volume id editor window before creating the image.

PAD:
Insert silence between audio tracks. See cdrecord(1) for more information.

Multi-session:
You can add new tracks to an existing CD. The previously stored data will not vanish.
IMPORTANT!!! You can create multi-session disks when you write the first
track in multi-session mode!

Burnproof:
Buffer Underrun Proof writing. If your writer supports this feature, you are suggested to
use it and check this box. In this case the program waits for data if the buffer is getting empty.

Other properties (2):


CD mount point:
The "Disk catalog" uses this property. "Disk catalog" will read the content of
disks from this directory. It is suggested to set up a directory as it is set
in the fstab for the cd-rw device. IMPORTANT!!! In the fstab it must be the cd-rw device,
because cdw will mount the disk under the directory specified there.

Auto disk catalog:
Add the disk to the catalog after writing.

Press <F10> to save and exit or <ESC> to quit without saving.

The properties displayed gray are disabled. For example if the properties
of MP3 encoding are grey, it is suggested to check the lame program.

Keys
----
<F1>     Display help
<F2>     Display and edit "Volume ID"
<F3>     Edit additional parameters given to cdrecord, e.g.: -overburn
<F4>     Select CD size
<F5>|<L> View last logfile
<F6>     Information about raw disc material (cdrecord -atip) (overwrites last log :( )
<F10>    Display the GPL 
<L>      Display the content of logfile
<E>      Eject CD-RW tray
<C>      Disk Catalog
<Q>      Quit

Accessibility
-------------
Mail bug reports to <acerion@poczta.wp.pl>
Latest release: http://cdw.sourceforge.net

Jun 26, 2007

