cd2mp3 README - Ver 0.4 - JAH 26/09/00
======================================

CD2MP3 - Written by Jamie Heckford, jamie@jamiesdomain.co.uk
Uses bladeenc and dagrab (freeware)

Introduction
------------

cd2mp3 takes the hassle away from trying to remember dagrab and bladeenc command line switches,
and having to go through the process of having to use 2 programs to make an mp3. cd2mp3 brings
up a small set of prompts asking you how you would like the mp3 created. Answering them takes
about 10 seconds, and then cd2mp3 will encode the mp3 for you.

Changes
-------

* Minor Bugfixes
* More compact code due to cleanups

Requirements
------------

cd2mp3 requires the following:

Perl 5 (minimum) Installed as /usr/bin/perl (see troubleshooting if it is elsewhere)

bladeenc installed in your path

dagrab installed in your path 

Root access (cd2mp3 needs this to extract the tracks from the cd-rom at the mo)

Bladeenc and Dagrab can both be found at our download area which is http://download.cd2mp3.org.uk/

Installation
------------

Change to the directory you unpacked the gzipped file to and run: ./install
This will place the program in /usr/local/bin and clean up the temp directory.

F.A.Q
-----

1.) Where can I obtain the most resent version from??
1.A) http://www.jamiesdomain.org.uk/

2.) Do I have to pay for it?
2.A) Nope, cd2mp3 is freeware. Donations are accepted though :)

3.) Can I modify the source?
3.A) Copying is the biggest form of flattery. Seriously, feel free to, just leave my name in it :)  

4.) I hate the program.
4.A) Remove it then. 

Troubleshooting
---------------

1.) Perl is not installed as /usr/bin/perl

Solution: Open up the cd2mp3 file (in vi or similar). It is installed in /usr/local/bin/cd2mp3. Change
          the first line #!/usr/bin/perl to: #!/path/to/perl/on/your/system

2.) I don't have bladeenc or dagrab.
 
Solution: You can obtain the latest versions from our download area which is http://download.cd2mp3.org.uk/ 

3.) I don't have root Access

Solution: This is a problem at the moment. If you do not have root access there will be a workaround
          for this in the future that allows you to rip tracks without being root. Setuid root works
          on some systems, on most it does not.

4.) It doesn't work!!

Solution: Please mail any bug reports (including the error message if given and information on your machine)
          to: jamie@jamiesdomain.org.uk

