General Information
-------------------
 cdcd takes a different approach from conventional console (or X) based CD
 players, in that it doesn't keep with the display-oriented paradigm.
 Conventional computer-based CD players resemble traditional physical CD
 players.  This is fine, if your user interface consists of 10 buttons.
 However, computers have keyboards, so why not use them?  Besides, it's
 certainly a waste of a console or an xterm to have a traditional CD player
 open anyway.

 cdcd works in two ways, accepting commands directly off the command line or
 in a query mode similar to other UNIX programs.  To pass a command to cdcd, 
 simply run cdcd with the command as the arguement (e.g. cdcd play).  This is
 great for using cron and cdcd together to make a CD alarm clock.  Or, you can
 run cdcd without arguements and you will be given the cdcd command prompt.

Installation
------------
 For help with installation, please see the file INSTALL.

Usage
-----

 After cdcd is installed, type 'cdcd'.  You should receive a prompt like this:

 cdcd>

 Enter a command, for example, help:

 cdcd> help
 cdcd commands:
  play   stop    open    close   pause   resume  ff      rew     ext
  next   prev    info    infoall status  edit    volume  quit
 cdcd>

 As you can see, the command will perform its function, and then return you to
 the command prompt.

 You can receive help on specific items by passing an arguement to the help
 function:

 cdcd> help play
 Usage: play [trackname, track #]

 By default, play starts at the beginning of the CD.  If you have the track 
 name database setup, you can invoke play followed by the trackname to start a
 track. You can also specify the track number.

 To play a CD, you can simply type 'play', or if you prefer, 'play Trackname',
 or 'play track#':

 cdcd> play Time

 When finished, simply type 'quit'

 cdcd> quit
 ~:$

 You can also pass commands to cdcd right off the command line:
 ~:$ cdcd info
 Album name:     The Dark Side Of The Moon
 Album artist:   Pink Floyd
 Total tracks:   9       Disc playing:   07:37 of 42:59
 Playing:        Time 03 00:01 of 07:05
 ~:$

CDDB Interface
--------------
 As of libcdaudio-0.4.2 (and cdcd-0.3.2), cdcd has supported the CD Database
 system, which allows retrieval of CD information off of the Internet.
 The CDDB interface is on by default.  Whenever a command is invoked that
 uses CD database information (e.g. play, ext, info, infoall) libcdaudio
 will search in the local cache (located under ~/.cddb) first, and if it
 is unable to locate information for the current CD, it will connect to
 a CDDB server and attempt to retrieve it.  If this is the first time you've
 used a particular CD with cdcd, you may notice a 5-10 second delay with the
 previously mentioned commands.  This is because cdcd is connecting to the
 CDDB server and retrieving disc information.  As soon as this has been 
 completed, the command will no longer block, and you will be given the
 shell prompt or cdcd command prompt again.

 If incorrect information appears for your disc, it is probably because
 the particular disc you inserted isn't in the CDDB, but it was similar
 to another CD in the CDDB.  You can manually change this information to
 the correct values using the 'edit' command.

 If all that comes up is several Unknowns, either there has been some error
 involving the CDDB server, or your disc isn't in the CDDB.  Again, you may
 change these from Unknowns to correct titles with the edit command.

 As of libcdaudio-0.4.3, a database system compatible with XFreeCD and xmcd
 is used.  This allows you to read CD information from discs played using
 XFreeCD and xmcd.

 As of libcdaudio-0.4.4, extended information is supported.  In cdcd, you can
 display extended information (if it is available) using the ext command.
 
CD-ROM Changer Support
----------------------
 If you own a CD-ROM changer, you can help me test out the CD changer
 functions in cdcd.  I don't have a CD-ROM changer, so I can't really test them
 myself.  In order for the CD-ROM changer functions to work, you must have a
 2.1 series kernel or better.
 
 If you care to help me test the CD-ROM changer functionality, please contact
 me at bascule@inferno.tusculum.edu.
 
Bugs
----
 All bug reports should be sent to bascule@procyon.mesa.k12.co.us.
  
 cdcd has been tested under many versions of Linux.  If you do experience
 problems either compiling or while operating cdcd, please send the following:
 
 * The version of cdcd you are using
 * The version of libcdaudio you are using
 * Your platform type and release
 * A complete list of errors that occoured either during the compile
   (make >& errors) or a detailed description of what happened while cdcd
   was in operation.
 * Any other information you believe is relevant.

Patches
-------
 If you think you can do something better than the existing code, by all
 means, send me the patch!  Send all patches to bascule@inferno.tusculum.edu.
 Be sure to include your name so I can credit your code.  If the patch fixes
 a bug, it would be nice if you could the patch along with the bug report.
