Grip
====

Grip is a cd-player and cd-ripper for the Gnome desktop.. It has the ripping
capabilities of cdparanoia builtin, but can also use external rippers (such
as cdda2wav). It also provides an automated frontend for MP3 encoders,
letting you take a disc and transform it easily straight into MP3s. Internet
disc lookups are supported for retrieving track information from disc
database servers. Grip works with DigitalDJ to provide a unified
"computerized" version of your music collection.


Requirements
============

To use Grip, you must have:

 o The Gnome desktop
 o POSIX thread support (http://pauillac.inria.fr/~xleroy/linuxthreads)
 o a net connection (if you want to use disc database lookup)
 o a CD player (surprise, surprise)

Grip is designed to work closely with DigitalDJ, my SQL-based mp3 jukebox
system (although it does not require it). DigitalDJ can be obtained from:

  http://www.nostatic.org/ddj

If you wish to have builtin cdparanoia support, or id3v2 support, you must
have the appropriate packages on your system. You can find them here:

 cdparanoia: http://xiph.org/paranoia/index.html
 id3v2: http://id3lib.sourceforge.net/

Grip requires that you have at least a basic version of the Gnome desktop
installed on your computer. You can find Gnome at:

 http://www.gnome.org/start/installing/index.php3

In particular, make sure that you have libghttp installed.


Installation
============

If you obtained Grip from the RPM distribution then they are already
installed. If you have the source distribution, you need to compile it.

To install Grip, simply go through the following steps:

 o after unpacking Grip, cd to the extracted directory
 o './configure'
 o 'make'
 o become root if you are installing in a non-user directory
 o 'make install'

Grip adds the following options that can be specified to configure:

  --disable-shared-cdpar  -- This will force Grip to link statically, rather
                             than dynamically with cdparanoia

  --disable-cdpar         -- This disable linking with cdparanoia entirely

  --disable-shared-id3    -- This will force Grip to link statically, rather
                             than dynamically with id3lib


Running Grip
============

Grip's usage is:

  grip [options]

  where the available options are:

    --device=DEVICE             Specify the cdrom device to use
    --scsi-device=DEVICE        Specify the generic scsi device to use
    --small                     Launch in "small" (cd-only) mode
    --local                     "Local" mode -- do not look up disc info on
                                the net
    --no-redirect               Do not do I/O redirection
    --verbose                   Run in verbose (debug) mode


For more information, see the online documentation.

---
Mike Oliphant (oliphant@gtk.org)

http://www.nostatic.org/grip