README for KIO_Burn 0.7
-----------------------

KIO_Burn is a package to let you burn CDs and DVDs using Konqueror. Actually,
you could in theory use it from any KDE program capable of opening and
saving via KDE's ioslave system. However, Konqueror is probably the easiest
way to burn discs.

PREREQUISITES
-------------

You must have the following installed:

  -  KDE version 3.3. You must have installed aKode (which is in the
     kdemultimedia package). I would recommend using KDE 3.3.2 if you can,
     I haven't tested with earlier versions.
  
  -  cdrecord and mkisofs. These tools are vital for writing CDs. They are
     included in the vast majority of GNU/Linux distributions. If you don't
     have them already they can be downloaded from:
     
     http://www.fokus.gmd.de/research/cc/glone/employees/joerg.schilling/private/cdrecord.html   
  
     Please note that it is very important that cdrecord can run setuid root.
     To do this, I used the command:
    
     # chmod 4711 /usr/bin/cdrecord
    
     If cdrecord is not setuid root, you will only be able to burn discs
     when logged in as root.
    
     I'm using mkisofs version 2.0.3 and cdrecord version 2.00.3, but i
     would be surprised if other versions don't work.

  -  DVD+RW-tools (http://fy.chalmers.se/~appro/linux/DVD+RW/)
  
  -  Taglib (http://developer.kde.org/~wheeler/taglib.html)
  
  -  libaudiofile (http://www.68k.org/~michael/audiofile/)
     
  -  Though it is not a requirement, kio_burn can make use of k3b's libraries to detect
     CD and DVD burners. This may be necessary to make some more obscure devices work.
     You can get k3b from www.k3b.org. You will need to install from source or install
     k3b development files if you are using a binary package and you want to compile
     kio_burn.
        
BURNING A CD
------------

Once kio_burn has been installed (see INSTALL for help), open up konqueror, and
type "burn:/" in the location bar.

To create a CD, first copy the files you want to copy to disc into
the "Data" directory, or drag audio files into the "Audio CD" directory
if you want to make an audio CD. Then go back to burn:/ and click on
"Burn Disc". Alternatively, click the yellowish CD in the Konqueror toolbar.

The first time you do this, you will be presented with a list of writer devices 
attached to your system. Select the device you want to use, insert a blank disc
in it, then click "Ok".

From the next screen, select if you want to create a data disc or an audio CD.
If you choose audio CD you will be given the chance to decide what order the
audio tracks will appear on your CD.

KIO_Burn will then scan the drive you selected for a valid writable disc. If there
are any errors follow the instructions on screen. When you are ready, click the
"Burn disc" button. 

You should see a progress dialog showing how your burning is going.

In subsequent recording sessions you will not be asked which recording device
you want to use. If you have more than one device and you want to switch 
between them, click on the "Settings" file in burn:/.

UNINSTALLING
------------

You can uninstall using the standard "make uninstall" command. Just a note:
don't forget to erase all the data you've got ready to burn in the "Data"
directory, otherwise you'll be leaving it all on your hard disk, taking up space.
The data is actually stored in a directory like ~/.kde/share/apps/kio_burn, so
you could always delete that directory after you uninstall.

There are a few packages of kio_burn available which can simplify installing
and uninstalling. Have a look at http://www-users.york.ac.uk/~jrht100/burn for
details. These will still not remove the data you have waiting to burn.

PROBLEMS
--------

KIO_Burn is beta software, so expect there to be problems.
If you think you've found a new bug, please send it to me at:
james@uncommonlygood.co.uk.

When sending bug reports, please don't forget to include any error messages
you see on the screen, plus the versions of KDE, mkisofs and cdrecord
that you are using.

COPYRIGHT / WARRANTY
--------------------

    kio_burn - An ioslave for burning optical discs 
    Copyright (C) 2004/05 James Thorniley 

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

    See the file COPYING for full details.

