1General Information 2=================== 3 4libcdaudio is a library designed to provide functions to control 5operation of a CD-ROM when playing audio CDs. It also contains 6functions for CDDB and CD Index lookup. 7 8Platforms 9========= 10 11libcdaudio will compile under the following platforms. Listed 12underneath them are any functions that will not work on that platform. 13 14Linux 1.2: CD-ROM changer functions will not work at all. 15 16Linux 2.0: You may select discs using the cd_changer_select_disc() 17function, but the cd_changer_slots() function will not work at all, 18and consequently, the cd_changer_stat() function will not work as 19well. 20 21Linux 2.1 and later: All functions should work correctly. 22 23OpenBSD 2.3: The tray open/close functions may not work correctly. 24CD-ROM changer functions will not work at all. 25 26FreeBSD 3.2: A kernel bug prevents you from ejecting the tray when 27there is no disc present. CD-ROM changer functions will not work at 28all. 29 30NetBSD: Might work (never tested). Please tell me if you can test 31libcdaudio on NetBSD. 32 33Solaris 2.5, 2.6: The tray open/close functions may not work 34correctly. CD-ROM changer functions will not work at all. 35cd_get_volume() will always return 0 for the volumes. 36 37Irix: As far as I know all function work within Irix. 38 39BeOS: A user contributed the file beos_cdaudio.c; it seems to work, 40except for CD changers. 41 42OSF/1: libcdaudio has limited and untested support for OSF/1. 43Although it may be able to list the tracks and read the CDDB/CD Index 44information, playing will probably fail and stopping will not work at 45all. If you are willing to test this on OSF/1, please e-mail me at 46noon@users.sourceforge.net. 47 48XBox: Most functions should work correctly. The XBox seems to lack 49the direct CDdrive->soundcard cable that is necessary to hear 50anything, though. 51 52Installation 53============ 54 55If you have received libcdaudio as part of another package, read the 56documentation in the top level source directory first to see if you 57need to compile libcdaudio separately. 58 59For help with installation, please see the file INSTALL. 60 61Thanks 62====== 63 64Thanks go to: 65 66Antony Arcieri, original author. 67Mike Oliphant for parts of the HTTP code. 68Ralph Wallace for ports to FreeBSD. 69Ryan Banks for incomplete ports to Digital UNIX. 70Justus Pendelton for ports to Solaris. 71Matt Kraai for additional Solaris help. 72David Rose for ports to Irix. 73Ryan Werber for a box to test the CD-ROM changer code on. 74Quinton Dolan for internal optimisations. 75Asheesh Laroia for making libcdaudio work on the XBox. 76 77If you aren't in this list, and you think you should be, just tell me. 78 79Bugs 80==== 81 82All bugs reports should be sent to noon@users.sourceforge.net. 83 84If you do experience any problems compiling, please send me: 85 86* The version of libcdaudio 87* Your platform type and release 88* the arguments and output of the configure script 89* A complete list of errors that occurred during the compile 90(e.g. make >& errors) and the configuration. 91* The CD-ROM header file for your platform so I can modify libcdaudio 92accordingly 93* Any other information you believe is relevant 94 95If you experience problems during the operation of programs compiled 96with this library, be sure to send: 97 98* The version of libcdaudio 99* The name and version of the program with which the error occurred 100* Your platform type and release 101* Any other information you believe is relevant 102 103Patches 104======= 105 106Send all patches to: noon@users.sourceforge.net 107 108Be sure to include your name so I can give credit where it is due. If 109the patch fixes a bug, it would be nice if you could send the patch 110along with the bug report. 111 112Licence 113======= 114 115libcdaudio is distributed under the GNU Library General Public 116License, included in this package under the top level source directory 117in the file COPYING. 118 119Projects interested in libcdaudio 120================================= 121 122This list is useful for me to learn what people want about libcdaudio, 123how it is used by them, how libcdaudio should evolve to meet 124everyone's needs. 125 126If you know of a program that should be added in this list, feel free 127to tell me, please. 128 129bebocd 130cajun (http://www.dvhart.com/projects/cajun/) 131cddb-slave, cddb-slave2, gnome-cd, gnome-media (http://mail.gnome.org/archives/gnome-multimedia/2002-September/msg00030.html) 132cdplayer.app (http://tucows-linux.up.pt/preview/9098.html) 133demcd 134disc-cover (http://homepages.cwi.nl/~jvhemert/disc-cover.html) 135dmc, dmcd 136freeamp/zinf borrowed code from libcdaudio 137www.freedb.org (http://www.dtype.org/pipermail/fdb-apps/2002-August.txt) 138fxcd 139globecom jukebox (http://sourceforge.net/projects/gjukebox/) 140gnome-media (gnome-cd) 141grip (uses a fork from libcdaudio, it seems) 142low-grimoire (at BerliOS) 143macos x (http://macosx.forked.net/bbarchive/forum5/000116.html) 144massrip (http://kfa.cx/) 145matrix-devices devcdplayer (http://futurelab.aec.at/matrix/02_docu/devdoc/devdoc.html) 146mp3make2 147musicbrainz 148mycd (http://un1c0.freewebpage.org/) 149mythtv/mythmusic (http://www.mythtv.org/docs/mythtv-HOWTO-15.html) 150open music machine (http://pficheux.free.fr/omm/) 151http://ozcdplayer.sourceforge.net/ 152paloma 153perl Audio::CD 154pycdaudio 155rbcd (Ruby) 156record manager (http://www.theossoft.net/index.html) 157rhythmbox (http://www.rhythmbox.org/) 158ripper 159sdl 160simplecd (http://nofx.cse.unsw.edu.au/code/simplecd.pml) 161sumi (xtunes.sf.net) 162a tcl/tk package (http://tcltk.free.fr/index.php3?idxcat=3) 163uraten (http://www2.pos.to/~rero2/works/uraten/uraten_index.html) 164the witty cd player (http://www.softonic.com/ie/17060) 165wmsvencd 166xmms (currently uses its own internal library) 167yaret (http://www.nongnu.org/yaret/) 168