CDPlayer.app
============

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

CDPlayer is useful only if your CD drive is directly connected with your
sound card. It cannot cope with SATA drives where it is necessary to read
the digital data from the disc and then convert it to audio output.

This application is GPL'ed.. read the COPYING file.
All bugs reports should be sent to Andreas Schik <andreas@schik.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.12.
  libcdaudio is available here: http://libcdaudio.sourceforge.net.

o To set up CDPlayer's preferences you will either need Preferences.app or
  SystemPreferences. CDPlayer offers panels for both systems.
  You may of course set up the preferences manually using 'defaults write'.

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

o To build CDPlayer.app simply do the following:
	make
  This will build CDPlayer, the AudioCD bundle and the prefences panel for
  Preferences.app.

  If you want to build the preferences panel for SystemPreferences build
  CDPlayer like this:
	make prefs=sysprefs

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

o To install CDPlayer.app in your global GNUstep directory do:
	make install
  or
	make prefs=sysprefs install
  or
	make prefs=no 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 the selected preferences panel.


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

gnustep-make	1.21
gnustep-base	1.21
gnustep-gui	0.19
gnustep-back	0.19

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 the AudioCD backend, first. This bundle is
responsible for detection of inserted CDs. It will check a list of devices as
set up in its NSUserDefaults.
On the command line, you can set the defaults like this:

% defaults write AudioCD Devices "(/dev/cdrom, /dev/cdrecorder)"

You may of course use one of the preferences panels as well to do this in a
graphical manner.
This list may be empty. In that case the AudioCD backend will not poll any
device for CDs.

In addition to this list AudioCD accepts a custom device path to be checked.
This custom device has precedence over the list and will be polled in any case.

CDPlayer.app uses its own preferences key 'Device' to pass as custom device to
the AudioCD bundle.

% openapp CDPlayer.app [--Device=<path_to_cd_device>]
