Join GitHub today
GitHub is home to over 50 million developers working together to host and review code, manage projects, and build software together.Sign up
CDPlayer.app ============ Introduction ------------ CDPlayer 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 Schik <email@example.com>. How to build CDPlayer.app ------------------------- o You must install libcdio, libcdio_cdda and libcdio_paranoia, first. These libraries are needed for reading the CDDA data. o As CDPlayer uses Cynthiune's output bundles to make the CD audible, you must install Cynthiune before you can build CDPlayer. o Also Required is Cddb.bundle by Yen-Ju Chen. This bundle is included with CDPlayer. See below for details. o To build CDPlayer simply do the following: make This will build CDPlayer and the AudioCD and Cddb bundles. o To install CDPlayer in your global GNUstep directory do: make install This will install CDPlayer in $(GNUSTEP_LOCAL_ROOT)/Applications and the AudioCD and Cddb bundles in $(GNUSTEP_SYSTEM_ROOT)/Library/Bundles. The AudioCD bundle does all the audio CD handling. o By default, CDPlayer sends out desktop notifications on each new track to indicate the currently played track. This feature can be turned off by building CDPlayer like this: make notifications=no o As of version 0.8.0, CDPlayer uses the Musicbrainz service to retrieve disc information. You must install libmusicbrainz5, libdiscid and libcoverart to build CDPlayer. To turn off Musicbrainz support do: make musicbrainz=no Cddb is turned off by default. To turn on Cddb support do: make cddb=yes o As of version 0,8,0, CDPlayer supports reading CD-TEXT. If an audio CD contains respective information, CDPlayer does not query Musicbrainz or Cddb. As the CD-TEXT feature can be relatively slow, you can switch it off if you don't want it by building like this: make cdtext=no o As of version 0.7.0, CDPlayer is able to display cover art, i.e. the front cover of the currently played CD is displayed in the main window. This feature is integrated into the Musicbrainz bundle and automatically available. It can no longer be turned off. Cynthiune --------- CDPlayer has been developed and tested against Cynthiune 1.0.0. Cynthiune is part of GAP, which can be found here: http://gap.nongnu.org/ CDDB/FreeDB suport ------------------ CDPlayer uses the Cddb bundle from Yen-Ju Chen to access FreeDB databases. The Cddb source code is integrated with CDPlayer. The original Cddb bundle project is available here: http://savannah.nongnu.org/projects/musicbox/ Running ------- 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>] If no device is given, AudioCD.bundle will poll all devices for audio CDs. It will play the first on, it can find. Cached Data ----------- CDPlayer caches cover art files. This speeds up loading of already known CDs. The files are located in $HOME/GNUstep/Library/CDPlayer/coverart. Cddb information is no longer cached. However, existing cache files in $HOME/GNUstep/Library/CDPlayer/coverart/discinfo are still used. Deleting these files should do no harm.