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