1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
.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<tab>
cdcd> play "See<tab>
cdcd> play "See You On The Other Side"
.fi
.RE
.SH REPORTING BUGS
Report bugs to <noon@users.sourceforge.net>
|
