Burn.app
========
Burn.app (fka GSburn.app) is a GNUstep based CD burning program.
It serves as front-end for Joerg Schilling's cdrtools
(cdrecord and mkisofs), cdrdao, and cdparanoia.
You will no longer need to remember ugly command line parameters
for cdrecord or write shell scripts (I know, I know. The purists
among us decline the usage of any graphical tool. But as a purist
you didn't download this application in the first place and thus
won't read this anyway ;-).
With Burn.app you compile your CD by point-and-click operation
and save your projects for later reuse. Burn.app will hide as
many settings as possible from you, thus making it very easy and
user-friendly to create your own CDs.

Burn.app has now reached version 0.4.1.


Platforms
=========
Burn.app is developped and tested on a x86 PC running GNU/Linux.
Being a GNUstep application, it may be portable to other platforms
where GNUstep is available (and the external tools, of course).


Requirements
============

Before you install Burn.app, you must make sure that the following
software is installed on your system. Otherwise you might not even be
able to compile Burn.app.


GNUstep
-------
Of course, Burn.app needs a GNUstep (www.gnustep.org) environment
to run. It has been developed and tested in the following environment:

gnustep-make 1.9.0
gnustep-base 1.9.0
gnustep-gui  0.9.4
gnustep-back 0.9.4

Burn.app will not run with older versions of GNUstep, in particular -gui.


GWorkspace.app
--------------
For adding files and directories you will need an appropriate "file manager"
being able to communicate with Burn.app via DnD. Currently, there is only
GWorkspace.app. Any version from on 0.6.0 should do.
Install GWorkspace.app according to its instructions.


CDPlayer.app
------------
You also need CDPlayer.app to use Burn.app. This is because Burn.app
uses the AudioCD.bundle included in CDPlayer.app to read an audio
CD's TOC. Burn now also relies on CDPlayer for adding audio CD tracks to a CD
description either via DnD or using the new services.
CDPlayer.app can be downloaded at:

http://sourceforge.net/project/showfiles.php?group_id=61565&release_id=132392

You need at least version 0.4.0 of CDPlayer.app.

More recent versions may be on CVS:
cvs -d:pserver:anonymous@cvs.gsburn.sourceforge.net:/cvsroot/gsburn login
password is empty
cvs -z3 -d:pserver:anonymous@cvs.gsburn.sourceforge.net:/cvsroot/gsburn co CDPlayer

Unpack the tar ball and do:

> make
> make install


Other software
--------------
As mentioned above, Burn.app uses several external tools to
actually accomplish the tasks of ripping audio CDs or burning CDs.
The package does _not_ contain these external tools, namely
cdrecord, mkiofs, and cdparanoia. These must be acquired and
installed separately.
Burn.app has so far been tested with the following versions (Note,
that other versions may work, too, but were not tested.):

cdrecord  (www.fokus.gmd.de/usr/schilling/cdrecord.html)
	1.11a05, 2.01
	To use ATAPI devices under Linux without the SCSI emulation driver
	you need at least version 2.0.

mkisofs   (www.fokus.gmd.de/usr/schilling/cdrecord.html)
	2.01

cdparanoia III rel. 9.8.  	(www.xiph.org/paranoia)

Get the packages and install them according to their specific instructions.

The only software that is optional is cdrdao. You may not install this
program and the according bundle and still have the complete functionality
of Burn.app available.


Future plans
------------
Burn.app will move towards using libburn and libisofs (http://icculus.org/burn).
The cdrtools backends will then be only optional tools that can be installed
additionally.
The reason for this is mainly the somewhat arrogant attitude of Schily wrt
helping other people with their problems and wrt to the 'brokenness' of other
tools than his cdrtools. Another reason is also a technical one. Using a
library seems somewhat easier than starting and communicationg with external
programs.

Installation
============

Before you install Burn.app you should deinstall any old version of GSburn.app.
This is because Burn.app is the replacement for GSburn.app.
They may coexist, but you want need GSburn.app anymore.


After installing the above stuff simply do

> tar xzf burn-xxx.tar.gz
> cd burn-xxx
> make
> make install

This will install everything needed to run Burn.app except
the external tools (see above).

The cdrdao backend bundle is no longer part of the release archive. If you
ish to use cdrdao for burning, dowload the bundle's source code separately
from SF and install it according to its instructions.

If you want the documentation to be created, call

> make doc=yes.

This will create one additional directory, DeveloperDoc,
containing documentation on the classes, protocols, functions
and so on. However, this feature is far from being finished, yet.


HOWTO
=====

Howto what? Burn.app is designed to be simple, easy to use and intuitive ;-)
Seriously, check the online help for further assistance.


Disclaimer
==========

Burn.app is in a beta state and not yet stable. You use it at
your own risk. I cannot be made responsible for any damage to your
hardware or for spoiled raw media.


Contact
=======

For bug reports, feature requests, or just for chatting contact the author:

Andreas Schik <aheppel@web.de>

or visit Burn.app's homepage:

http://gsburn.sourceforge.net.
