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
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
|
General Information
-------------------
cdcd takes a different approach from conventional console (or X) based CD
players, in that it doesn't keep with the display-oriented paradigm.
Conventional computer-based CD players resemble traditional physical CD
players. This is fine, if your user interface consists of 10 buttons.
However, computers have keyboards, so why not use them? Besides, it's
certainly a waste of a console or an xterm to have a traditional CD player
open anyway.
cdcd works in two ways, accepting commands directly off the command line or
in a query mode similar to other UNIX programs. To pass a command to cdcd,
simply run cdcd with the command as the arguement (e.g. cdcd play). This is
great for using cron and cdcd together to make a CD alarm clock. Or, you can
run cdcd without arguements and you will be given the cdcd command prompt.
For information regarding cdcd and new releases, visit
http://cdcd.undergrid.net/
Installation
------------
For help with installation, please see the file INSTALL.
Usage
-----
After cdcd is installed, type 'cdcd'. You should receive a prompt like this:
cdcd version x.x.x, Copyright (C)1998-99 Tony Arcieri
Distributed under the GNU General Public License. See file COPYING for details.
Built with libcdaudio version x.x.x
cdcd>
Enter a command, for example, help:
cdcd> help
cdcd commands:
play stop open close pause resume ff rew sites
next prev getvol setvol status rndplay slot list submit
info tracks edit ext refresh device verbose quit access
cdcd>
As you can see, the command will perform its function, and then return you to
the command prompt.
You can receive help on specific items by passing an arguement to the help
function:
cdcd> help play
Usage: play [starttrackname/track #] [endtrackname/track #] [min:sec]
By default, play starts at the beginning of the CD. You may specify tracks
using either the number of the track or a section of the track's name. The
disc will play from where it starts to the end of the disc or a track you
specify. You may also specify a position within the first track to start.
To play a CD, you can simply type 'play', or if you prefer, 'play Trackname',
or 'play track#.' You may also specify a track at which to end play, and
also a time within the track to start. Here are a few examples:
cdcd> play 5
This would play track #5 and stop at the end of the disc.
cdcd> play Time
This would play the first song on the disc with "Time" as a part of
its name and stop at the end of the disc.
cdcd> play Time 5
This would play the first song on the disc with "Time" as part of its
name and stop at track #5.
cdcd> play Time 3:30
This would play the first song on the disc with "Time" as part of its
name and start 3 minutes and 30 seconds into the song and stop at the
end of the disc.
cdcd> play 3 5 3:30
This would play from track 3 to track 5 and start 3:30 into track 3.
cdcd> play 3 "Us and Them" 5:00
This would play from track 3 to the first song on the disc with "Us and
Them" as part of its title and start 5:00 into track 3.
cdcd> play 5 5
This would play track 5 and stop at the end of track 5; an easy way to
play only a single track.
cdcd> play 3:30
This would set the postition within the current song to 3:30.
If you are in interactive mode and are finished, simply type quit. The CD
will continue playing:
cdcd> quit
~:$
You can also pass commands to cdcd right off the command line:
~:$ cdcd info
Album name: The Dark Side Of The Moon
Album artist: Pink Floyd
Total tracks: 9 Disc playing: 07:37 of 42:59
Playing: Time 03 00:01 of 07:05
~:$
CDDB Interface
--------------
As of libcdaudio-0.4.2 (and cdcd-0.3.2), cdcd has supported the CD Database
system, which allows retrieval of CD information off of the Internet.
The CDDB interface is on by default. Whenever a command is invoked that
uses CD database information (e.g. play, ext, info, infoall) libcdaudio
will search in the local cache (located under ~/.cddb) first, and if it
is unable to locate information for the current CD, it will connect to
a CDDB server and attempt to retrieve it. If this is the first time you've
used a particular CD with cdcd, you may notice a 5-10 second delay with the
previously mentioned commands. This is because cdcd is connecting to the
CDDB server and retrieving disc information. As soon as this has been
completed, the command will no longer block, and you will be given the
shell prompt or cdcd command prompt again.
Automated CDDB operation is not liked by some. You can enable verbose,
manual CDDB operation by using the verbose command:
cdcd> verbose
CDDB messages are off
New CDDB message setting (on/off): on
cdcd>
From now on, any command that uses the CDDB code will tell you exactly what
it is doing:
cdcd> info
Trying cddbp://www.cddb.com:8880/
Connection established.
Retrieving information on 770f0d19.
Inexact match for 770f0d19.
Please choose from the following inexact matches:
1: The Beach Boys / Made In U.S.A.
2: None of the above.
> 1
Downloading data...
Album name: Made In U.S.A.
Album artist: The Beach Boys
Total tracks: 25 Disc length: 64:15
Stopped
cdcd>
Of course, all of that will only happen the first time you use the disc with
cdcd. Normally the CDDB information will simply stay cached in ~/.cddb.
As of libcdaudio-0.4.3, a caching system compatible with XFreeCD and other
CD players is used. This allows you to read CD information from discs
played using these other players.
As of libcdaudio-0.4.4, extended information is supported. In cdcd, you can
display extended information (if it is available) using the ext command.
CD-ROM Changer Support
----------------------
Linux 2.1 and 2.2 users with CD-ROM changers may take advantage of the CD-ROM
changer functions within cdcd.
To use your CD-ROM changer with cdcd, there are only two functions you must
know, list and seldisc:
cdcd> list
Disc 1: 42:59 Pink Floyd / The Dark Side of the Moon
Disc 2: 44:28 Pink Floyd / Wish You Were Here
Disc 3: 42:39 Led Zeppelin / IV
cdcd>
The list command displays the contents of your CD-ROM changer. To choose a
particular disc from the CD-ROM changer, use the slot command:
cdcd> slot 1
Controlling CDDB Operation
--------------------------
As of libcdaudio 0.6.1, cdcd uses a radically different CDDB interface. If
you previously generated a ~/.cddbrc you should delete it.
All CDDB operations use specific URLs for the server. To use the CDDB server
cddb.cddb.com that operates on port 8880, you should use the following URL:
cddbp://cddb.cddb.com:8880
If instead, you wished to use the HTTP server www.cddb.com port 80, use:
http://www.cddb.com:80/~cddb/cddb.cgi
Notice /~cddb/cddb.cgi on the end. This is the path to the actual CDDB CGI,
and must be used with any HTTP URL.
To automatically update the CDDB server list, use the 'sites refresh' command.
Any further CDDB operations will pull entries from this list. If the first
server fails, it will automatically go on to the next one, until it has
exhausted the whole list.
Bugs
----
All bug reports should be sent to cdcd@gjhsnews.mesa.k12.co.us.
cdcd has been tested under many versions of Linux, and FreeBSD 3.0. If you
do experience problems either compiling or while operating cdcd, please send
the following:
* The version of cdcd you are using
* The version of libcdaudio you are using
* Your platform type and release
* A complete list of errors that occoured either during the compile
(make >& errors) or a detailed description of what happened while cdcd
was in operation.
* Any other information you believe is relevant.
Patches
-------
If you think you can do something better than the existing code, by all
means, send me the patch! Send all patches to bascule@inferno.tusculum.edu.
Be sure to include your name so I can credit your code. If the patch fixes
a bug, it would be nice if you could the patch along with the bug report.
A few final words
-----------------
cdcd is distributed under the GNU General Public License, included in this
package under the top level directory in the file LICENSE.
libcdaudio is distributed under the GNU Library General Public License,
either included in this package as libcdaudio/LICENSE or if obtained
seperately, under the top level directory of libcdaudio in the file LICENSE.
|
