----------------------------
***Grafburn CD/DVD burner***
----------------------------

Grafburn-0.10 released May 2007

***About***
Grafburn is a simple set of shell scripts that create
a gui around cdrtools, making it possible to easily
create and burn data and audio cd's and dvd's. It is
intended to be small, simple, and easy to navigate,
while providing an interface to the most common
burning tasks.

With Grafburn you can
  * Create data cd's or dvd's
  * Burn already existing iso images
  * Blank cd and dvd media
  * Create and encode audio cd's (ogg, mp3, or wav supported,
    flac, ape, m4a, aac, and mp4 when the right extra packages
    are installed)
  * Create audio cd's using a cue or toc file (if cdrdao is installed)
  * Directly copy cd's or dvd's from one drive to another
  * Append data to a multisession disk
  
Grafpup cannot (but will)
  * Encode to and from other audio formats
  * Burn on the fly

***Usage***
Grafburn is an AppDirectory. This is a special program
which is completely contained inside a directory, and
the directory itself can be run as a program from ROX-filer.
The launcher is in /usr/local/apps. Right click to get a
shortcut menu. Alternatively, Grafburn can be run from the 
command line and accepts the following argumants.
  * -n opens the dialog to create a new iso
  * -a opens the dialog to create an audio cd
  * -c opens the dialog to copy a cd or dvd
  * -b opens the dialog to burn an existing iso image
  * -p opens the preferences dialog
  * -h displays the help file
  * -f burns a cd based on a file list

Being a very simple program it uses simple solutions for
most tasks. To create a data cd you link the files that
should go into the cd inside a temp directory.
Grafburn will then create an iso image, which is an
image of the cd filesystem, and give you the choice
whether or not to burn it right away. You can set the
location of the temp directory as well as the location
where the iso image will be created using the preferences
dialog.

It is also possible to burn an already created image,
and blanking of cdrw is also supported. Dvdrw blanking
should be possible but is untested.

Audio cd creation is new but is progressing quickly. There
is no fancy playlist or file browser, instead you just burn
an entire directory of audio files. The files can be in any
format, but if the format is unknown to Grafburn it will be
passed over rather than being converted to the desired output.
If the files are all converted to wav format the resulting cd
will be playable in most normal audio cd players.

Out of the box, Grafburn understands wav, mp3, and ogg
formats. There is support for decoding wma but not encoding.
If you install flac then it will be able to encode and decode
flac files. Installing mac does the same for ape files, while
the faad2 package will add decode only support for mp4 and
m4a formats which are common because of itunes and nero. As
of version 0.10 Grafburn can also burn a disk using cue or 
toc files to define the audio tracks (using cdrdao).

Brand new in 0.9.1 is a function to directly copy a cd or dvd
from one drive to another. This works best if you have cdrdao
installed, but can be used with just cdrtools (which does add
a few extra steps). However, without cdrdao you cannot directly
copy an audio cd. You will have to rip it first using Pbcdripper
or some other program. This is a limitation of cdrtools itself
and would not be easy to code around so I don't intend to bother.
Cdrdao comes standard in Grafpup and some releases of Puppy. For
Puppy releases that do not include cdrdao it can be installed
via pupget/petget.

It is also possible to copy a disk if you have only one drive,
but for now this is limited to data cd's only. Again, if you want
to copy an audio cd you will have to rip the tracks first, even
if you have cdrdao installed.

In all cases it is a not a good idea to have a lot of other
programs running while burning a disk. The burning process must
be able to keep the buffer full, of the disk you are burning runs
the risk of being ruined.

***Changelog***
0.10 -
  * Added support for cue and toc files
  * Added workaround for drives that must use -raw mode as opposed to -sao
  * Allow files to be symlinked into temp directory
  * Greatly simplified burning dialog moving everything into one window
  * Total rewrite of preferences dialog usig gtkdialog, all into one window now
  * Use the system default drives set up using the burning wizard
  * Implemented appending tracks to multisession disks
  * Rewrote most of the audio cd interface in gtkdialog - more streamlined
  * Made relocation of the application directory easier
  * Implemented version upgrades
  * Created a nicer "About" screen
0.9.1 -
  * Fixed two small bugs in the preferences dialog to improve reliability.
  * Added 8x and 16x burning speeds for dvd's (per kevs on the forum).
  * Added a prototype function for copying cd's and dvd's
0.9 -
  * Fixed bugs in the blanking and burning scripts, was getting an error
     that the drive was mounted.
  * When trying to blank or burn a disk, if the default burner is set it
     now forces you to set one before continuing.
  * Cosmetic improvements to the preferences dialog.
  * The main window can now be closed while another operation is running.
  * Fixed the menu entry to point to the correct wrapper script.
  * Using the command 'grafburn' now accepts commandline options.
0.8 -
  * Added decoding support for mp4 and m4a via faad2
  * Added decoding for wma format
  * Simplified the existing code in the audio encoding stage
  * Removed the rox popup window from the audio cd creation stage
  * Updated some dialog windows and main help
  * Now packaged in PET format
0.7 -
  * Fixed possible bug in audio cd creation, which could wipe out a directory
  * Overhauled audio encoding, now a separate script
  * Gui only pops up one terminal window for all encoding functions
  * Program now checks for flac and mac executables, and supports encoding to
     flac or mac respectively if found
0.6 -
  * Audio cd's created from wav files will now play in a normal cd player
  * Moved drive selection to the preferences dialog
  * eliminate one dialog window (see above)
  * Added burn speed selection to the burning commands
  * updated preferences dialog with extra options
  * added title to rxvt windows
  * filer window now automatically closes after audio cd creation
  * AppRun forces preferences setup if grafburnrc does not exist
0.5 -
  * Added basic audio cd creation, with encoding to and from
      ogg, mp3, and wav
  * Changed the run action for the help file per PLineJ
  * Removed unused icons
  * No longer call burniso2cd. Grafburn handles iso selection
      internally now
  * Added tooltip for launcher

0.4 -
  * New preferences dialog
  * Improved main window
  * Several bugfixes

***Future***
Support for more encoding to more audio formats. Mostly done.

Support for "ElTorito" bootable disks.

Rewritten preferences dialog, using a tabbed gtkdialog interface. Done.

Burn disks on the fly, without having to create an image first.

Overall code cleanup, including combining several scripts into
one. It was written this way primarily for ease of debugging.

