cd2mp3 README - Ver 0.81 - JAH 21/01/01
======================================

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

This program can be freely distributed, modified, sold etc.. as
long as this banner message and links to my website are retained
in the source code.

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

cd2mp3 takes the hassle away from trying to remember dagrab and lame 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/cd/tracks for you.

Changes
-------

* Bug in Menu Option 5 fixed
* Fixed wildcard filename input for lame in entire CD option
* Entire CD option now deletes wav files progessively, using less disk space

(Thanks to Derek Harper for work on the above)

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

cd2mp3 requires the following:

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

LAME installed in your path

dagrab installed in your path 


LAME 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 (as root): ./install
This will place the program in /usr/local/bin and clean up the temp directory.

If you can't get root access then copy the cd2mp3 binary/script to whereever you wish.

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 LAME or dagrab.
 
Solution: You can obtain the latest versions from our download area which is http://download.cd2mp3.org.uk/ 

3.) 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

