1CDPlayer.app
2============
3
4Introduction
5------------
6CDPlayer.app is a small CD Audio Player for GNUstep. This application is
7only tested on Linux/GNUstep.
8
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.
12
13This application is GPL'ed.. read the COPYING file.
14All bugs reports should be sent to Andreas Schik <andreas@schik.de>.
15
16
17How to build CDPlayer.app
18-------------------------
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.
22
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'.
26
27o Also Required is Cddb.bundle by Yen-Ju Chen. See below for details.
28
29o To build CDPlayer.app simply do the following:
30	make
31  This will build CDPlayer, the AudioCD bundle and the prefences panel for
32  Preferences.app.
33
34  If you want to build the preferences panel for SystemPreferences build
35  CDPlayer like this:
36	make prefs=sysprefs
37
38  If you do not want to build any preferences panel, do the following:
39	make prefs=no
40
41o To install CDPlayer.app in your global GNUstep directory do:
42	make install
43  or
44	make prefs=sysprefs install
45  or
46	make prefs=no install
47
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.
52
53
54GNUstep system
55--------------
56o CDPlayer.app 0.5.1 has been tested on GNU/Linux using the following versions
57  of GNUstep:
58
59gnustep-make	1.21
60gnustep-base	1.21
61gnustep-gui	0.19
62gnustep-back	0.19
63
64CDDB/FreeDB suport
65------------------
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:
69
70cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/musicbox co Cddb.
71
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
74project page:
75
76http://sourceforge.net/project/showfiles.php?group_id=61565&release_id=132392
77
78Make sure you get the latest release (currently it's named cddb.bundle-0.2).
79Unpack it and as always do:
80
81> make
82> make install
83
84
85Running
86-------
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:
91
92% defaults write AudioCD Devices "(/dev/cdrom, /dev/cdrecorder)"
93
94You may of course use one of the preferences panels as well to do this in a
95graphical manner.
96This list may be empty. In that case the AudioCD backend will not poll any
97device for CDs.
98
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.
101
102CDPlayer.app uses its own preferences key 'Device' to pass as custom device to
103the AudioCD bundle.
104
105% openapp CDPlayer.app [--Device=<path_to_cd_device>]
106