.TH CDCD 1 .SH NAME cdcd \- Command Driven CD player .SH SYNOPSIS .B cdcd .RI [ OPTION ]... .RI [ COMMAND ] .SH DESCRIPTION .B cdcd allows control of a CD player either directly off of the command line or in its own interactive query mode. Invoking cdcd without a command will cause cdcd to enter query mode. Invoking cdcd with a command will cause cdcd to execute that command and then terminate when it is finished. .SH OPTIONS .TP .BI \-\-device " DEVICE" .TP .BI \-d " DEVICE" Use .I DEVICE as the CD device. .I DEVICE is the device special file name of the CD-ROM device. Do not use a Linux SCSI Generic device. .SH USAGE The following are the supported commands: .TP \fBplay\fR [\fBstart track\fR] [\fBend track\fR] [\fBmin\fR:\fBsec\fR] If \fBstart track\fR is specified, play will play the specified track instead of the first track. If \fBend track\fR is specified, the disc will be played from the start track to the end track. \fBstart track\fR and \fBend track\fR may either be part of or an entire track title. If a starting position is specified (in the form \fBmin\fR:\fBsec\fR), then the disc will begin playing the specified amount of time into the specified track. One may specify a starting position without specifying a \fBstart track\fR or only specify a \fBstart track\fR and starting position while specifying no \fBend track\fR .TP .B stop This will stop the CD if it is playing. .TP \fBopen\fR, \fBeject\fR This will eject the CD-ROM tray .TP .B close This will close the CD-ROM tray .TP .B pause This will pause the CD if it is playing .TP .B resume This will cause a paused CD to resume playing .TP \fBff\fR [\fBmin\fR:\fBsec\fR] This will fast-forward the CD 15 seconds by default, or the specified amount of time .TP \fBrew\fR [\fBmin\fR:\fBsec\fR] This will rewind the CD 15 seconds by default, or the specified amount of time .TP .B next This will advance the CD one track .TP .B prev This will return the CD to the previous track .TP .B getvol This will return the current volume settings .TP \fBsetvol\fR [\fBleft front\fR] [\fBright front\fR] [\fBleft rear\fR] [\fBright rear\fR] Sets the CD-ROM volume to the given settings. Most CD players only support the front two channels .TP .B status Gives only numerical data regarding the CD's status .TP .B info Gives disc name, artist, current track name, and disc positions .TP .B tracks Lists all tracks on the CD and their lengths .TP .B rndplay Plays a random track .TP .B list Lists all CDs in a CD-ROM changer .TP .B slot Changes the current CD in the CD-ROM changer .TP \fBedit\fR [\fBname\fR, \fBartist\fR, \fBgenre\fR, \fBtrack no.\fR] [\fBvalue\fR] Edits information about the disc. You may specify \fBname\fR, \fBartist\fR, \fBgenre\fR, or the number of the track you wish to edit .TP \fBext\fR [\fBtrack no.\fR, \fBdisc\fR] This will display extended information about the disc. If no parameter is given it will display information about the current track. Specifying \fBdisc\fR will display information for the disc itself .TP .B refresh This will connect to a server and retrieve information about the CD even if there already exists information about it. Otherwise, this is done automatically by any command that uses disc/track names .TP \fBdevice\fR [\fBdevice name\fR] This sets the CD-ROM device cdcd will use in future invocations which don't specify the \-d option. .B cdcd stores this information in your .I .cdcdrc file. .TP \fBverbose\fR [\fBon\fR, \fBoff\fR] This toggles whether cdcd will display everything that is happening (e.g. when accessing a CDDB or CD Index server) .TP .B quit Exits cdcd .TP \fBsites\fR [\fBrefresh\fR, \fBdisplay\fR, \fBadd\fR, \fBdelete\fR, \fBmove\fR] This edits the server list. More specific help on each of the commands is available by typing \fBcdcd help sites\fR .TP \fBsubmit\fR [\fBe-mail address\fR] This will submit a CDDB entry to a CDDB server .TP \fBaccess\fR [\fBlocal\fR, \fBremote\fR, \fBproxy\fR] Specifying \fBlocal\fR will cause CD information requests to return Unknown for track, artist, and album titles, and will not attempt to connect to any servers. \fBremote\fR will cause cdcd to connect to a server whenever any CD information is required. If you need to use a HTTP proxy, it may be specified in the form \fBproxy url\fR, where \fBurl\fR is the URL for your HTTP proxy .SH COMPLETION cdcd uses traditional readline command and trackname completion. To complete a command, simply hit 'tab' when you have typed a partially completed command. To complete a trackname, first type whatever command you wish to pass a track name to (e.g. play, ext) and then begin with a double quotation mark. Type the beginning of the track name and then hit tab. The track name will be completed for you. .PP .RS .nf cdcd> pl cdcd> play "See cdcd> play "See You On The Other Side" .fi .RE .SH REPORTING BUGS Report bugs to