
            --------------------------------------------
             CDPlayer.app (CD Audio Player for GNUstep)
            --------------------------------------------


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

CDPlayer.app is a small CD Audio Player for GNUstep. This application is
only tested on Linux/GNUstep.

This application is GPL'ed.. read the COPYING file.
All bugs reports should be sent to Andreas Heppel <aheppel@web.de>.


How to build CDPlayer.app
-------------------------

o You must install libcdaudio first. It should be version 0.7.0 or higher.
  I have tested it with version 0.99.6.
  libcdaudio is available here: http://libcdaudio.sourceforge.net.

o You will also need Preferences.app by Jeff Teunissen as the AudioCD.bundle
  installs a configuration plug-in there. Preferences.app is available at
  http://www.nongnu.org/backbone. From there go to Savannah and get the latest
  CVS version.

o Also Required is Cddb.bundle by Yen-Ju Chen. See below for details.

o To build CDPlayer.app simply do the following:
	make

  If you do not want to build the preferences panel, do the following
	make prefs=no

o To install CDPlayer.app in your global GNUstep directory do:
	make install

  This will install CDPlayer.app in $(GNUSTEP_LOCAL_ROOT)/Applications and
  AudioCD.bundle in $(GNUSTEP_SYSTEM_ROOT)/Library/Bundles. AudioCD.bundle does
  all the audio CD handling.
  This will also install AudioCD.prefs a plug-in to Preferences.app.

  Alternatively, you can do:
	make prefs=no install
  to prevent the preferences panel being installed.


GNUstep system
--------------

o CDPlayer.app 0.4.1 has been tested on GNU/Linux using the following versions of
  GNUstep:

gnustep-make	1.9.1
gnustep-base	1.9.1
gnustep-gui	0.9.2
gnustep-back	0.9.2

o Note, that CDPlayer may or may not run on older versions. This is mainly due to
  changes in Gorm files, but may have other reasons, too.


CDDB/FreeDB suport
------------------
CDPlayer.app uses the Cddb.bundle from Yen-Ju Chen
(http://www.people.virginia.edu/~yc2w/GNUstep/english/) to access FreeDB
databases. Cddb.bundle is available here using CVS:

cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/musicbox co Cddb.

You can as well download the source tar ball from SourceForge, if for any reason
you don't want to checkout the whole MusicBox. It is located on Burn.app's
project page:

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

Make sure you get the latest release (currently it's named cddb.bundle-0.2).
Unpack it and as always do:

> make
> make install


Running
-------

You should set up the defaults for AudioCD, first. This can be done manually
using defaults write. Currently, AudioCD expects an array containing a list of
devices to be searched for CDs. AudioCD will detect changes in any of these
devices automatically. In addition to this list AudioCD accepts a custom device
path to be checked.
The prefrences for AudioCD.bundle can now also be set using the plug-in for
Preferences.app.
CDPlayer.app passes the string for its prefrences key 'Device' if present.

% defaults write AudioCD Devices "(/dev/cdrom, /dev/cdrecorder)"
% openapp CDPlayer.app


Thanks to:
----------

Andrew Lindesay (andrew@onevision.de) for his beautiful icons.
