cdw is a front-end for some command-line tools used for burning data CD and
DVD discs and for related tasks. The tools are: cdrecord/wodim,
mkisofs/genisoimage, growisofs, dvd+rw-mediainfo, dvd+rw-format. You can
also use cdw to rip tracks from your audio CD to raw audio files. Limited
support for copying content of data CD and DVD discs to image files is also
provided. cdw can verify correctness of writing ISO9660 image to CD or DVD
disc using md5sum program (if it is installed on target machine).

cdw uses ncurses library to build user interface and it can be used
in UNIX terminal window and in terminal emulator (like konsole, xterm,
rxvt or gnome-console) in X Window environment.

cdw is developed and tested on my Debian GNU/Linux x64 machine. Basic tests
on i386 machine (Debian) are also performed.

The program automatically creates ~/.cdw.conf in your home directory. This
distribution package contains a cdw.conf file, which is a sample
configuration.

cdw also creates log file, default location is in /tmp directory, but you
can change this in cdw configuration window.



Web pages
---------
http://cdw.sourceforge.net/
http://sourceforge.net/projects/cdw/




Requirements
---------------------
cdw 0.6.0 was tested on two different machines running Debian:
32-bit Debian GNU/Linux 5.0
64-bit Debian GNU/Linux squeeze/sid
with following software/hardware:

 - UNIX terminal, at least 80x24 chars
 - gnu libc library:
   on 32-bit machine: libc6, 2.7-18lenny4
   on 64-bit machine: eglibc (Embedded GNU C Library), 2.11.2-6
 - ncurses library with support for wide characters:
   on 32-bit machine: ncursesw5, 5.7+20081213-1
   on 64-bit machine: ncursesw5, 5.7+20100313-4
 - cdio library: multi platform library for accessing your CD hardware,
   on 32-bit machine: libcdio7, 0.78.2+dfsg1-3
   on 64-bit machine: libcdio10, 0.81-4
 - iso9660 library from cdio project:
   on 32-bit machine: libiso9660-5, 0.78.2+dfsg1-3
   on 64-bit machine: libiso9660-7, 0.81-4
 - recent versions of mkisofs/genisoimage, cdrecord/wodim, dvd+rw-tools
   (the tools aren't absolutely required in order to run cdw, but are
   needed to do anything useful with cdw)
 - md5sum: used to verify ISO images written to CD and DVD
 - properly configured cd/dvd writer
 - linux kernel 2.6




Install
-------
Copy cdw-0.6.0.tar.gz to your source directory, such as /usr/local/src and
'untar' the archive. Compile and install. It goes like this:

tar -xzf cdw-0.6.0.tar.gz
cd ./cdw-0.6.0
./configure
make
make install

"./configure" script accepts "--enable-debug" flag, which enables debug
messages printing some debug information (INFOs, WARNINGs and ERRORs)
to stderr. You want to use this flag only if you want to hack cdw.

"make" recognizes "check" target - this executes some unit tests for basic
functions used by cdw.

For generic information on installation see INSTALL file in main directory
of this package.




Program parameters
------------------
cdw accept the following parameters:
-v | --version      : display the version number of cdw
-h | --help         : display help
--enable-dvd-rp-dl  : enable support for DVD+R DL (buggy, with dvd+rw-tools only)




Usage
-----
Please refer to cdw man page for usage instructions. You can find man page in
man directory. If cdw is already installed on your system, just type
   man cdw
in your command line.




Credits
-------
Check AUTHORS file in main directory of this package for list of
people who are or were authors of this software.

Check THANKS file in main directory of this package for list of people
who have contributed to this software in other ways.

This project uses files from gnulib package (from version licensed under
"GPL2 or later"). See cdw/gnulib dir for list of files.

src/optical_file_systems/iso9660.h: J. Schilling (cdrecord)
src/optical_file_systems/isosize.c: J. Schilling & Jonas Munsin (cdrecord)
Original thread code (now found in src/external_tools/cdw_thread.c): Sharad Mittal (CDrecorder)




News
----
Check NEWS file in main directory of this package for most recent news.




GTK GUI
-------
Older versions of cdw had GTK interface, that could be enabled on compile
time. cdw no longer provides this option. ncurses interface is the only
user interface available.




Hacking
-------
If you are interested in hacking cdw you may want to start with these files:
TO BE DONE




Contact, bug reports
--------------------
Kamil Ignacak, acerion@wp.pl
http://cdw.sourceforge.net



21 October 2010

