NAME

rip - read an audio cd to wav/mp3/ogg/flac... files and create a tocfile


SYNOPSIS

  rip [options] artist-name/album-title
  options:
    -h, --help         - Show the help message then exit
    -V, --version      - Show the version message then exit

    -n, --norip        - Do not read CD (tracks already present)
    -w, --wav          - Leave in wav format (do not encode)
    -k, --keep         - Keep the wav files (after encoding)
    -t, --notoc        - Do not ask to create a tocfile
    -e, --noedit       - Do not ask to edit the tocfile
    -m, --noname       - Do not ask to name the track files
    -g, --notag        - Do not ask to tag the track files

    -C, --cdda2wav     - Read CD with cdda2wav
    -P, --cdparanoia   - Read CD with cdparanoia
    -R, --reader cmd   - Read CD with arbitrary "cmd"

    -L, --lame         - Encode as mp3 with lame (lossy)
    -N, --notlame      - Encode as mp3 with notlame (lossy)
    -G, --gogo         - Encode as mp3 with gogo (lossy, fast)
    -B, --bladeenc     - Encode as mp3 with bladeenc (lossy)
    -O, --oggenc       - Encode as ogg with oggenc (lossy, smart)
    -F, --flac         - Encode as flac with flac (lossless)
    -E, --encoder cmd  - Encode with arbitrary "cmd"

    -2, --2args fmt    - The -E cmd takes in.wav and out.fmt (not *.wav)
    -b, --bitrate kbps - Override default bitrate (192)
    -r, --root dir     - Override default music directory (/mnt/music:/mnt/spare)


DESCRIPTION

rip reads an audio cd (unless -n) into wav files and then encodes the wav files into a smaller format such as mp3, ogg or flac (unless -w). The default reader and encoder programs to use and the default encoding bitrate are specified in /etc/jukebox.conf. The -C, -P and -R options override the default reader. The -L, -N, -G, -B, -O, -F and -E options override the default encoder. The -b option overrides the default bitrate (unless -E). After encoding the tracks, the wav files are removed (unless -k).

If an encoder specified with the -E command takes lame-style arguments (i.e. ``in.wav'' and ``out.mp3'' rather than just ``*.wav'') then use the -2 option whose argument specifies the suffix for the output files.

The argument is the directory in which to place the track files. This directory is interpreted as being relative to the first directory listed in the juke_root variable in /etc/jukebox.conf. This is /mnt/music:/mnt/spare by default. It can be overridden with the -r option. It is expected that the directory argument will comprise two parts. The top level is the artist directory and the level below that is the album directory. This isn't strictly necessary, though. If a directory is not specified, the track files are placed in the current directory.

After reading the tracks but before encoding them, rip asks if you want to create a table of contents file (unless -t). If so, rip asks if you want to retrieve cddb information from freedb.org. If so, the tocfile is populated with this information. Finally, you can check/categorise the tocfile using $EDITOR or /bin/vi (unless -e). The tocfile is called something like ``00-<artist>-<title>.toc'' (based on the juke_toc variable in /etc/jukebox.conf).

After creating the table of contents and encoding the track files, rip asks if you want to name the track files (unless -m) to something more descriptive than that which results from cd reader software (i.e. track##.cdda.mp3 or audio_##.mp3). If so, toc2names uses the table of contents to provide suggestions for all track names but the user must confirm or override each suggestion.

After naming track files, rip asks if you want to tag the files (unless -g). If so, toc2tags uses the table of contents to supply the tag information. The genre is taken to be the first word in the ``Jukebox:'' header which should be the category obtained via cddb. The only formats that can be tagged are mp3, ogg and flac.


EXAMPLES

Rip a CD for use by the jukebox

  rip janis-joplin/cheap-thrills

Rip a CD to the current directory, leaving in wav format

  rip -w

Rip a CD to the current directory, encoding to the default format

  rip


FILES

  /etc/jukebox.conf - System wide configuration file
  ~/.jukeboxrc      - User specific configuration file


SEE ALSO

  rip(1), riptrack(1), mktoc(1), toc2names(1), toc2tags(1),
  cdr(1), cdrw(1), burn(1), burnw(1), cdbackup(1), mp3backup(1),
  jukebox(1), jukeboxc(1), jukeboxc.jar(1), jukeboxd(8),
  jukeboxd-init.d(8), jukebox.conf(5),
  http://raf.org/jukebox/Jukebox-HOWTO


AUTHOR

raf <raf@raf.org>