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, xorriso.
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 or some of shaXsum programs (if 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.

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

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



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




Requirements
---------------------
cdw 0.8.1 was tested on two machines:

64-bit Debian GNU/Linux 8
with following software/hardware:

 - UNIX terminal, at least 80x24 chars
 - libc library: glibc, 2.19-18
 - ncurses library with support for wide characters: ncursesw5, 5.9+20140913-1
 - cdio library: multi platform library for accessing your CD hardware,
   libcdio13, 0.83-4.2
 - iso9660 library from cdio project: libiso9660-8, 0.83-4.2
 - burn library from libburnia project: libburn4
 - recent versions of mkisofs/genisoimage, cdrecord/wodim, dvd+rw-tools,
   xorriso, mkudffs, rsync (the tools aren't absolutely required in order 
   to run cdw, but are needed to do anything useful with cdw)
 - md5sum, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum: used to
   verify ISO images written to CD and DVD
 - properly configured cd/dvd writer
 - linux kernel 4.3.5


64-bit Linux Mint 17.2 Rafaela
with following software/hardware:

 - UNIX terminal, at least 80x24 chars
 - libc library: eglibc (Embedded GNU C Library), 2.19-0
 - ncurses library with support for wide characters: ncursesw5, 5.9+20140118
 - cdio library: multi platform library for accessing your CD hardware,
   libcdio13, 0.83-4.1
 - iso9660 library from cdio project: libiso9660-8, 0.83-4.1
 - burn library from libburnia project: libburn4 1.3.4-0
 - recent versions of mkisofs/genisoimage, cdrecord/wodim, dvd+rw-tools,
   xorriso, mkudffs, rsync (the tools aren't absolutely required in order 
   to run cdw, but are needed to do anything useful with cdw)
 - md5sum, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum: used to
   verify ISO images written to CD and DVD
 - properly configured cd/dvd writer
 - linux kernel 3.16.0-38-generic


Install
-------
Copy cdw-0.8.1.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.8.1.tar.gz
cd ./cdw-0.8.1
./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)
--escdelay=X        : modify ESC key delay period; 'X' is non-negative time in milliseconds




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



02.04.2016

