1grip(1) grip(1)
2
3
4
6 grip - A gtk-based cd-player and cd-ripper.
7
8 gcd - A gtk-based cd-player (used as part of grip, or alone).
9
11 grip [-d <device>] [-s] [-l]
12
13 gcd [-d <device>] [-f] [-l]
14
15
17 Grip is a gtk-based cd-player and cd-ripper. It has the ripping capa‐
18 bilities of cdparanoia builtin, but can also use external rippers (such
19 as cdda2wav). It also provides an automated frontend for MP3 encoders,
20 letting you take a disc and transform it easily straight into MP3s. The
21 CDDB protocol is supported for retrieving track information from disc
22 database servers. Grip works with DigitalDJ to provide a unified "com‐
23 puterized" version of your music collection. GCD is the cd- player only
24 version of Grip.
25
26 Because Grip and GCD share much of their functionality, this file docu‐
27 ments both of them. If you installed only GCD, you should ignore the
28 bits that talk about "ripping" and "encoding" of tracks.
29
30 Grip is designed to work closely with DigitalDJ, my SQL-based mp3 juke‐
31 box system (although it does not require it).
32
34 These are the command-line options for grip:
35
36 -d <device> Use <device> as the cd-rom device (default: /dev/cdrom).
37
38 -s Launch grip in a "small" (cd-only) mode.
39
40 -l "local" mode -- don't try to use CDDB.
41
42 --version
43 Print version string, and exit.
44
45 -v Verbose (debug) mode.
46
47 These are gcd's command-line options:
48
49 -d <device> Use <device> as the cd-rom device (default: /dev/cdrom).
50
51 -f Launch gcd in "full" (track-display) mode.
52
53 -l "local" mode -- Don't try to use CDDB.
54
55 -v Verbose (debug) mode.
56
58 The most handy way to launch Grip/GCD is from your window manager's
59 doc. A dock icon (gripicon.tif/gcdicon.tif) is included with the dis‐
60 tribution.
61
62 Grip's operation should be pretty self-explanatory. Tracks to rip are
63 selected with the right mouse button. To select all tracks on the disc,
64 click the "Rip" column label. When you select "Rip" or "MP3-encode"
65 from the "Rip" page, Grip will rip or rip/encode the tracks you have
66 selected. If you select "Rip partial track", only the current select of
67 the current track will be ripped or encoded. Start/End sector values
68 are ignored if partial track ripping is not enabled.
69
70 Grip and GCD used to be installed as setuid root. This was for several
71 reasons. First, most people have their systems configured such that
72 their user account does not have access to the cd drive. Secondly,
73 cdparanoia requires access to both the cd device and (for SCSI drives)
74 the generic SCSI device (usually /dev/sg<something>). Despite this, I
75 no longer install the programs setuid root. This means that you will
76 have to set the permissions correctly on the appropriate devices, or
77 run the program as root.
78
80 The "Config" menu allows you to configure your ripping program and your
81 CDDB database. Rip/Encode/ID3 options are only available in Grip.
82
83 Here are the options:
84
86 Don't interrupt playback on exit/startup
87 If this is not selected, Grip will stop play when it starts and
88 when it stops.
89
90 Rewind when stopped
91 If selected, Grip will rewind to the first track when play is
92 stopped.
93
94 Startup with first track if not playing
95 If this is not selected, Grip will begin with whatever track the
96 cd-player played last.
97
98 Reshuffle before each playback
99 If selected, Grip will re-randomize the tracks each time play‐
100 back begins when in shuffle-play mode.
101
103 Ripper
104 This allows you to select one of the preset rippers. This will
105 fill in sensible default parameters for calling the ripper. If
106 you select "grip (cdparanoia)", Grip will use its builtin ver‐
107 sion of cdparanoia (only available if paranoia has been compiled
108 in). If the builtin ripper is selected, the following options
109 are available:
110
111 Disable paranoia
112 Disables all paranoia checking.
113
114 Disable extra paranoia
115 Only cdda2wav-style overlap checking will be done.
116
117 Disable scratch detection
118 Do not look for scratches.
119
120 Disable scratch repair
121 Disable scratch repair (still detect)
122
123 Ripping executable
124 This should be the full path to the program you want to use to
125 rip tracks with.
126
127 Ripping command-line
128 These are the arguments that will be passed to the ripping pro‐
129 gram. The '%' switches are translated as follows:
130
131 %t Track to be ripped
132
133 %b Begin sector to be ripped (0 is start of track)
134
135 %e End sector of track
136
137 %f Filename to put .wav data to
138
139 Rip file format
140 This specifies the format of the filename to write ripped data
141 to. The '%' switches are translated as follows:
142
143 %n Name of track being ripped
144
145 %t Number of track being ripped
146
147 %a Artist of current track
148
149 %A Artist of the current disc
150
151 %d Name of current disc
152
153 %b Begin sector to be ripped (0 is start of track)
154
155 %e End sector of track
156
157 %c cdrom device
158
159 %i CDDB discid in hex format
160
161 %g ID3 genre tag as a number
162
163 %G ID3 genre tag as a word
164
165 Adding a '*' between the '%' and the switch will cause underscoring of
166 the field to be skipped.
167
168 Rip 'nice' value
169 The 'nice' (priority) level to run the rip at.
170
171 Max non-encoded .wav's
172 The maximum number of non-encoded .wav files Grip will keep
173 around before pausing ripping.
174
175 Auto-rip on insert
176 If selected, Grip will automatically select all tracks and begin
177 ripping when a new (ie: no local disc data) disc is inserted.
178
179 Auto-eject after rip
180 If selected, Grip will automatically eject the disc when ripping
181 is finished.
182
183 Wav filter command
184 This command will be run after ripping but before encoding. It
185 can be used to call a program to manipulate the .wav file in
186 some way (such as doing normalization). It accepts a single
187 switch, %f, which translates as the ripped .wav file.
188
190 Encoder
191 This allows you to select one of the preset rippers. This will
192 fill in sensible default parameters for calling the encoder.
193
194 MP3 executable
195 This should be the full path to the program you want to use to
196 MP3-encode tracks with.
197
198 MP3 command-line
199 These are the arguments that will be passed to the MP3 encoder.
200 The '%' switches are translated as follows:
201
202 %b Encode bitrate (kbits/sec)
203
204 %f Filename of the .wav data to be encoded
205
206 %o Filename to save mp3 data to
207
208 MP3 file format
209 This specifies the format of the filename to write MP3 data to.
210 The '%' switches are the same as those used in the rip file for‐
211 mat.
212
213 Delete .wav after encoding?
214 If selected, this option will (surprise!) delete the ripped
215 .wav file after encoding.
216
217 Insert into SQL database
218 If selected, and DigitalDJ is installed, Grip will place the
219 song information into DigitalDJ's song database.
220
221 Number of CPUs to use
222 This is the number of simultaneous encode processes allowed. If
223 you have an SMP system, increase this number to use more pro‐
224 cesses. Note that Grip must be restarted for changes in this
225 option to take effect.
226
227 MP3 'nice' value
228 The 'nice' (priority) level to run the MP3 encode at.
229
231 ID3 Executable
232 The full path to the program that will add ID3 tags to an MP3
233 file
234
235 ID3 Command-line
236 The arguments to be passed to the ID3 program. The % switches
237 are translated as:
238
239 %n Name of track
240
241 %t Number of track
242
243 %a Artist of current track
244
245 %A Artist of the current disc
246
247 %d Name of current disc
248
249 %g ID3 genre tag as a number
250
251 %G ID3 genre tag as a word
252
253 %y Year of track
254
255 %f Name of the MP3 file
256
257 Add ID3 tags
258 If selected this option will cause ID3 tags to be added to each
259 MP3 file after it is encoded.
260
262 Primary/Secondary CDDB server
263 These are your servers for looking up disc information over the
264 net. If the disc is not found on the primary server, the sec‐
265 ondary server will be checked.
266
267 DB server
268 The address of the CDDB server you wish to use.
269
270 DB CGI path
271 The path to the script on the server that handles HTTP requests.
272 This is generally "~cddb/cddb.cgi" or "cgi-bin/cddb.cgi".
273
274 Perform CDDB lookup automatically
275 If selected, Grip will always try to look up an unknown disc. If
276 not selected, lookup must be initiated manually.
277
279 Use proxy server
280 If selected, CDDB requests will be sent through an HTTP proxy
281 (useful for people behind firewalls).
282
283 Get server from 'http_proxy' env. var:
284 If set, Grip will try to read the http server/port information
285 from the environment variable "http_proxy", which should take
286 the form "http://server:port".
287
288 Proxy server
289 The address of the HTTP proxy server to be used.
290
291 Proxy port
292 The port to talk to the proxy on.
293
295 Output directory
296 The directory to place WAV and MP3 files in. The same '%'
297 switches as in the rip/encode filenames can be used.
298
299 Convert spaces to underscores
300 If selected, this will cause all spaces in filenames to under‐
301 scores.
302
303 Also underscore
304 A list of characters to replace with underscores when construct‐
305 ing filenames.
306
307 Email address
308 The email address to be used as a reply address when submitting
309 CDDB entries and bug reports.
310
311 CD update program
312 This program will be run whenever a disc is put in the drive.
313 All sensible '%' switches can be used. I use this to call a pro‐
314 gram that generates a web page that tells what CD I'm currently
315 playing.
316
317 Keep application minimum size
318 If selected, Grip will always try to keep its window a the mini‐
319 mum size possible.
320
322 I have declined to sign a license agreement with Escient, the company
323 who owns "www.cddb.com" and runs the CDDB server "us.cddb.com". Their
324 license would (among other things) have required me to place advertise‐
325 ments in Grip and restrict you, the user, to use only their databases.
326 I am against this commercial use of the track information submitted by
327 users such as yourself. For this reason, I encourage you to use free
328 servers, such as "freecddb.freecddb.org".
329
331 Grip and GCD are Copyright (c) 1998 by Mike Oliphant. Grip and GCD may
332 be used and distributed under the terms of the GNU General Public
333 License. All other brand and product names are trademarks, registered
334 trademarks or service marks of their respective holders.
335
336 These programs are distributed in the hope that it will be useful, but
337 WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
338 CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
339 Public License for more details.
340
341 You should have received a copy of the GNU General Public License in a
342 file named COPYING along with this distribution; if not, you can con‐
343 tact the Free Software Foundation, Inc., https://www.fsf.org/.
344
346 Thanks go to:
347
348 * Everyone involved in GTK development for a wonderful GUI
349
350 * Tony Arcieri, for libcdaudio, which formed the basis of Grip's
351 low-level cd control and CDDB access routines
352
353 * Monty, for cdparanoia and the paranoia library
354
355 * Heiko Eissfeldt for cdda2wav
356
357 * Tord Jansson for BladeEnc
358
359 * Mike Cheng, Mark Taylor and all the others who have worked on
360 LAME
361
362 * Ti Kan, for the xmcd button bitmaps, many of which I use in mod‐
363 ified form
364
365 * Everyone that has contributed code to Grip (see the CREDITS and
366 ChangeLog files)
367
368 * Everyone else who has given me feedback and helped test Grip
369
371 If you have trouble with Grip or GCD, read the "FAQ" section in the
372 built in manual. If you still have a question after reading through
373 this document carefully, or have a feature request, feel free to send
374 an email to the mailinglist, or open a bug repport on the bug tracker.
375 Do read the file TODO first and skim through the feature request bug
376 tracker, to check whether it's already on my list.
377
379 See the ChangeLog file that came with the source code.
380
382 Grip and GCD written by Mike Oliphant (oliphant@gtk.org)
383 Documentation formatting by Aaron Sherman (ajs@ajs.com)
384 Project manager: Johnny A. Solbu (johnny@solbu.net)
385
386
387
388 2018-05-22 grip(1)