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


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'

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 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>      Use <device> as cd-rom device
    --small                Launch in "small" (cd-only) mode
    --local		   'local' mode -- don't try to use DiscDB
    --no-redirect          Do not do I/O redirection
    --verbose              Verbose (debug) mode


For more information, see the online documentation.

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

http://www.nostatic.org/grip
