
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.

Install of Disk catalog
-----------------------
If you would like to use the "Disk catalog" , you must install the mysqlclient
and mysqlclient-dev packages or sqlite and sqlite-dev before compiling. In
Debian Woody the name of these packages are: libmysqlclient10 and
libmysqlclient10-dev.  The configure will detect these packages and the
complied code will contain this feature. In this case, you will have a new tool
called cdwdic.  IMPORTANT! The /doc directory contains a cdw.sql file. You must
install this to your system for using the "Disk catalog". The installation
process is very simple:

With MySQL:
mysql <cdw.sql

With SQLite:
sqlite database_file < cdw_sqlite.sql

If you would like to install as an other user or the user has password
or by any chance the target system will be an other system, you can install
the database with the following method:

mysql -u username -p [password] -h hostname < cdw.sql

You will need to set these up in the options (see later).

Program parameters
------------------
cdws accept the following parameters:
-c | --catalog : running in "Disk catalog" mode.
-g | --gui     : running with GTK interface
-v | --version : display the version number of cdw
-h | --help    : display help

cdwdic knows the following parameters:
add <name> <no> <category> <date>: add new disk into catalog. 
    <name> the name of disk
    <no> the number of disk (must be a number)
    <category> the name of the category (new categories are automatically created)
    <date> any date that you want to store. For example the date when the disk is added.
search <string>
    Search the <string> in the name of files and directories. Case insensitive!
show <name>
    Display the contents of <disk>.
list [-c <category>]
    Display the name and number of disks. With -c as an optional parameter
    only the disks in <category> category displayed.

Usage
-----
The menu:

Add files: Select files and directories for the cdimage. Press <space> to 
select a file || directoy, 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.
		
Copy CD image: Make an image from a CD in your drive.
		
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.
		
Copy data CD: Copy existing data CD from CD-ROM. (A reader and a writer devise is suggested :)
		
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
-------
Here you can configure cdrecord and mkisofs, also cdda2wav, 
lame, oggenc and MySQL, if accessible. Use the General and Other tabs. 
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.

MySQL host:
The name of the host where the cdw database installed. It is possible to use different
computers for cdw database and cdw (program). In this case cdw will handle the
data over the network. Here you must specify the name or the ip of the host where
you installed the database. If the program and the database are on the same computer,
use localhost (default).

MySQL user:
The name of the user who can access cdw database.

Audio directory:
cdw will rip tracks to this directory from audio CDs.

Stereo:
Rip audio tracks in stereo mode.

Bit per channel:
8 or 16

Echo to sound device:
While you are "copying" audio tracks from CD, the sound is also copied to soundcard. In this
way you can listen to the CD, but the speed will be 1x.

Encode to Ogg:
The output files will be in Ogg Vorbis format with real-time encoding.

High quality:
Generate VBR encoded files.

Encode to MP3:
The output files will be in MP3 format with real-time encoding.

Bitrate:
Constant bitrate: 128, 192 or 256 are possible values.

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
<A>      Add disc to disk catalog (if installed)
<G>      Rip audio CD
<Q>      Quit

Rip audio CDs
-------------
If you enter into the ripper interface, cdw searches for an audio CD. If
found, it displays the number of audio tracks. Enter again if you changed the disk in the
tray. The 'start track' contains track number of starting track and cdw will
copy tracks until 'last track'. If you would like to rip only the 5th track, you must
specify 5 for starting and 5 for end track also. Changes are saved when you start
the rip procedure with the <G> key.

Disk catalog
------------
The Disk catalog is a standalone part of cdw. Previously we used 'dic' but it wasn't
too interactive and we started to develop our catalogizer. This disk catalog is based on
MySQL. You can enter into the catalog interface in to ways: pressing <C> in main menu of
cdw or start cdw with -c (or --catalog) parameter. You can navigate with the left and right
arrows on the keypad between the menu and the categorized files. The main level always displays
the name of categories. Inside these lists you can find the disks, directories and files.
You can enter into the the category, disk or directory with <ENTER>. You can go one
level up with <BACKSPACE>. The bottom of screen displays information about currently
selected item.

Disk catalog menu:
Show all disk: display all disks without categories in disk number order. You can go 
back with <BACKSPACE> or with / key.

Add disk: add new disk to catalog.
1. Insert the disk into CD-RW.
2. Enter the name of disk.
3. Enter the NUMBER of disk.
4. Enter the name of category which will contain the disk.
You can quit the 'add disk' procedure by pressing <ESC>. If the category doesn't exist yet,
cdw will create it. cdw will mount the disk if you set the fstab item with
correct device name and mountpoint.

Search: you can search in the names of files and directories. Enter the string that you 
want to find and the result of search will be displayed. cdw will search in all categories,
disks and directorie. After the search you can see all disks which contain the specified
string. The program will show the search results until requesting "Show all disk". The
top of the screen (the search label) informs you about the type of information on the screen.
If checked you can see the result of search else you can see everything.

Delete: delete a disk or category from the catalog. By deleting a disk or category, all items in that 
container will be deleted, too! As you delete a category, all disks are in that category are deleted,too!
The program will asks you before deletion whether you are sure to delete that item.

Quit: exit from disk catalog. If you start cdw with -c or --catalog parameter, you will exit
from the program, otherwise you will go back to the cdw main menu.

Keys:
F1     - Display help window
->     - Enter into catalogized files window
<-     - Enter into main menu of disk catalog.
ENTER  - Change between category, disk or directory.
BSPACE - Go up one level
DEL    - Delete disk or category
A      - Add disk to catalog
S      - Show all
Q      - Exit from disk catalog

Accessibility
-------------
Mail bug reports to <vbali@linuxforum.hu>
Latest release: http://cdw.sourceforge.net

Aug 26, 2003

