6CDPlayer.app is a small CD Audio Player for GNUstep. This application is
7only tested on Linux/GNUstep.
9CDPlayer is useful only if your CD drive is directly connected with your
10sound card. It cannot cope with SATA drives where it is necessary to read
11the digital data from the disc and then convert it to audio output.
13This application is GPL'ed.. read the COPYING file.
14All bugs reports should be sent to Andreas Schik <email@example.com>.
17How to build CDPlayer.app
19o You must install libcdaudio first. It should be version 0.7.0 or higher.
20 I have tested it with version 0.99.12.
21 libcdaudio is available here: http://libcdaudio.sourceforge.net.
23o To set up CDPlayer's preferences you will either need Preferences.app or
24 SystemPreferences. CDPlayer offers panels for both systems.
25 You may of course set up the preferences manually using 'defaults write'.
27o Also Required is Cddb.bundle by Yen-Ju Chen. See below for details.
29o To build CDPlayer.app simply do the following:
31 This will build CDPlayer, the AudioCD bundle and the prefences panel for
34 If you want to build the preferences panel for SystemPreferences build
35 CDPlayer like this:
36 make prefs=sysprefs
38 If you do not want to build any preferences panel, do the following:
39 make prefs=no
41o To install CDPlayer.app in your global GNUstep directory do:
42 make install
44 make prefs=sysprefs install
46 make prefs=no install
48 This will install CDPlayer.app in $(GNUSTEP_LOCAL_ROOT)/Applications and
49 AudioCD.bundle in $(GNUSTEP_SYSTEM_ROOT)/Library/Bundles. AudioCD.bundle does
50 all the audio CD handling.
51 This will also install the selected preferences panel.
56o CDPlayer.app 0.5.1 has been tested on GNU/Linux using the following versions
57 of GNUstep:
66CDPlayer.app uses the Cddb.bundle from Yen-Ju Chen
67(http://www.people.virginia.edu/~yc2w/GNUstep/english/) to access FreeDB
68databases. Cddb.bundle is available here using CVS:
70cvs -d:pserver:firstname.lastname@example.org:/cvsroot/musicbox co Cddb.
72You can as well download the source tar ball from SourceForge, if for any reason
73you don't want to checkout the whole MusicBox. It is located on Burn.app's
78Make sure you get the latest release (currently it's named cddb.bundle-0.2).
79Unpack it and as always do:
82> make install
87You should set up the defaults for the AudioCD backend, first. This bundle is
88responsible for detection of inserted CDs. It will check a list of devices as
89set up in its NSUserDefaults.
90On the command line, you can set the defaults like this:
92% defaults write AudioCD Devices "(/dev/cdrom, /dev/cdrecorder)"
94You may of course use one of the preferences panels as well to do this in a
96This list may be empty. In that case the AudioCD backend will not poll any
97device for CDs.
99In addition to this list AudioCD accepts a custom device path to be checked.
100This custom device has precedence over the list and will be polled in any case.
102CDPlayer.app uses its own preferences key 'Device' to pass as custom device to
103the AudioCD bundle.
105% openapp CDPlayer.app [--Device=<path_to_cd_device>]