1grip(1)                                                                grip(1)
2
3
4

NAME

6       grip - A gtk-based cd-player and cd-ripper.
7

SYNOPSIS

9       grip [-d <device>] [-s] [-l]
10
11

DESCRIPTION

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
21       Grip is designed to work closely with DigitalDJ, my SQL-based mp3 juke‐
22       box system (although it does not require it).
23

OPTIONS

25       These are the command-line options for grip:
26
27       -c, --config=CONFIG
28              Specify the config file to use (in your home dir)
29
30       -d, --device=DEVICE
31              Use <device> as the cd-rom device (default: /dev/cdrom).
32
33       -s, --small
34              Launch grip in a "small" (cd-only) mode.
35
36       -l, --local
37              "local" mode -- don't try to use CDDB.
38
39       --no-redirect
40              Do not do I/O redirection
41
42       -v, --version
43              Print version string, and exit.
44
45       --verbose
46              Verbose (debug) mode.
47

USAGE

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
52       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

CONFIGURATION

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
64       Here are the options:
65

CD options:

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
71       Rewind when stopped
72              If  selected,  Grip  will rewind to the first track when play is
73              stopped.
74
75       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
79       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

Rip Options:

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
92       Disable paranoia
93              Disables all paranoia checking.
94
95       Disable extra paranoia
96              Only cdda2wav-style overlap checking will be done.
97
98       Disable scratch detection
99              Do not look for scratches.
100
101       Disable scratch repair
102              Disable scratch repair (still detect)
103
104       Ripping executable
105              This  should  be the full path to the program you want to use to
106              rip tracks with.
107
108       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
112       %t     Track to be ripped
113
114       %b     Begin sector to be ripped (0 is start of track)
115
116       %e     End sector of track
117
118       %f     Filename to put .wav data to
119
120       Rip file format
121              This  specifies  the format of the filename to write ripped data
122              to.  The '%' switches are translated as follows:
123
124       %n     Name of track being ripped
125
126       %t     Number of track being ripped
127
128       %a     Artist of current track
129
130       %A     Artist of the current disc
131
132       %d     Name of current disc
133
134       %b     Begin sector to be ripped (0 is start of track)
135
136       %e     End sector of track
137
138       %c     cdrom device
139
140       %i     CDDB discid in hex format
141
142       %g     ID3 genre tag as a number
143
144       %G     ID3 genre tag as a word
145
146       Adding a '*' between the '%' and the switch will cause underscoring  of
147       the field to be skipped.
148
149       Rip 'nice' value
150              The 'nice' (priority) level to run the rip at.
151
152       Max non-encoded .wav's
153              The  maximum  number  of  non-encoded  .wav files Grip will keep
154              around before pausing ripping.
155
156       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
160       Auto-eject after rip
161              If selected, Grip will automatically eject the disc when ripping
162              is finished.
163
164       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

Encode options:

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
175       MP3 executable
176              This should be the full path to the program you want to  use  to
177              MP3-encode tracks with.
178
179       MP3 command-line
180              These  are the arguments that will be passed to the MP3 encoder.
181              The '%' switches are translated as follows:
182
183       %b     Encode bitrate (kbits/sec)
184
185       %f     Filename of the .wav data to be encoded
186
187       %o     Filename to save mp3 data to
188
189       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
194       Delete .wav after encoding?
195              If selected, this option will  (surprise!)   delete  the  ripped
196              .wav file after encoding.
197
198       Insert into SQL database
199              If  selected,  and  DigitalDJ  is installed, Grip will place the
200              song information into DigitalDJ's song database.
201
202       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
208       MP3 'nice' value
209              The 'nice' (priority) level to run the MP3 encode at.
210

ID3 options:

212       ID3 Executable
213              The  full  path  to the program that will add ID3 tags to an MP3
214              file
215
216       ID3 Command-line
217              The arguments to be passed to the ID3 program.  The  %  switches
218              are translated as:
219
220       %n     Name of track
221
222       %t     Number of track
223
224       %a     Artist of current track
225
226       %A     Artist of the current disc
227
228       %d     Name of current disc
229
230       %g     ID3 genre tag as a number
231
232       %G     ID3 genre tag as a word
233
234       %y     Year of track
235
236       %f     Name of the MP3 file
237
238       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

CDDB options:

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
248       DB server
249              The address of the CDDB server you wish to use.
250
251       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
255       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

Proxy options:

260       Use proxy server
261              If selected, CDDB requests will be sent through  an  HTTP  proxy
262              (useful for people behind firewalls).
263
264       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
269       Proxy server
270              The address of the HTTP proxy server to be used.
271
272       Proxy port
273              The port to talk to the proxy on.
274

Misc options:

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
280       Convert spaces to underscores
281              If selected, this will cause all spaces in filenames  to  under‐
282              scores.
283
284       Also underscore
285              A list of characters to replace with underscores when construct‐
286              ing filenames.
287
288       Email address
289              The email address to be used as a reply address when  submitting
290              CDDB entries and bug reports.
291
292       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
298       Keep application minimum size
299              If selected, Grip will always try to keep its window a the mini‐
300              mum size possible.
301

CDDB notes

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

License and Disclaimer

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
317       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
322       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

Acknowledgments

327       Thanks go to:
328
329       *      Everyone involved in GTK development for a wonderful GUI
330
331       *      Tony  Arcieri,  for libcdaudio, which formed the basis of Grip's
332              low-level cd control and CDDB access routines
333
334       *      Monty, for cdparanoia and the paranoia library
335
336       *      Heiko Eissfeldt for cdda2wav
337
338       *      Tord Jansson for BladeEnc
339
340       *      Mike Cheng, Mark Taylor and all the others who  have  worked  on
341              LAME
342
343       *      Ti Kan, for the xmcd button bitmaps, many of which I use in mod‐
344              ified form
345
346       *      Everyone that has contributed code to Grip (see the CREDITS  and
347              ChangeLog files)
348
349       *      Everyone else who has given me feedback and helped test Grip
350

BUGS

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

CHANGES

360       See the ChangeLog file that came with the source code.
361

AUTHOR

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
367
368
369                                  2020-01-18                           grip(1)
Impressum