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