Provided by: ripit_3.9.0-2_all bug

NAME:

       ripit - Perl script to create flac, ogg, mp3, m4a (aac), als (mp4), mpc, wv or other files
       from an audio CD.

SYNOPSIS:

       ripit [options]

DESCRIPTION:

       This Perl script makes it a lot easier to create compressed sound files from an audio  CD.
       RipIT  supports Flac, Lame, Oggenc, Faac, mp4als, Musepack, Wavpack and ffmpeg. Artist and
       song  titles  are  retrieved  either  with  the  CDDB_get.pm  from  freedb.org  or   using
       WebService::MusicBrainz.pm from MusicBrainz.org.

       It  is  possible  to submit and edit CDDB entries at freedb.org, submission of MusicBrainz
       data need a login.  Hidden tracks and ghost songs are detected and split  into  chunks  of
       sound,  a  toc, cue or inf files permit to burn the WAV files with text and no gaps in DAO
       mode. Several encoder formats and qualities can be used in the same  run  (even  the  same
       encoder)  and  encoded  into different directories. Distributed ripping and launch of more
       than one encoder process in the same time is possible.

       Several manipulations on tags are supported, e.g. adding coverart,  detection  of  Various
       Artists  style at different levels or album gain; external commands can be launched before
       and after ripping / encoding is done with all CDDB information, e.g. to ensure presence of
       coverart, calculation of md5sums and playlistfiles can be done.

VERSION:

       RipIT Version 3.9.0

OPTIONS:

       [track_selection]
              Tracks to rip from.  If not specified,  all tracks will be ripped. Specify a single
              track by using a single number, or a selection of tracks using numbers separated by
              commas or hyphens, e. g. 2,6,10, or 3,5,7-9.  Using a number followed by a comma or
              hyphen will rip from that track to the end of the CD i. e. 3,5- rips  track  3  and
              from track 5 to the last one. Default: not set.

       --merge ordered list of comma separated intervals
              Place  a hyphen (-) or a plus (+) between first and last track number to be merged.
              Omitting the last number  will  merge  all  subsequent  tracks.   Separate  several
              intervals with commas. Default: not set.

       -I, --span start-endtime
              Define  an  interval  to be ripped when using cdda2wav or cdparanoia. The hyphen is
              mandatory.  The format of start and end-time is according to cdparanoia hh:mm:ss.ff
              in  hours/minutes/seconds/frames,  but  precision  is set to seconds, i. e.  frames
              will be ignored. Zero fields need not be specified and the value of seconds may  be
              larger than 60. When using cdda2wav this option translates the values to the -o and
              -d options of cdda2wav. When using option merge, endtime is  related  to  the  last
              track in the selection.  Default: not set.

       -o, --outputdir dir
              Where the sound should go. If not set, $HOME will be used. Default: not set.

       -d, --device cddevice
              Path of audio CD device, default: /dev/cdrom.

       --scsidevice cddevice
              Device name for special devices if the non ripping commands (except eject commands)
              shall be executed on a different device node. This might be  useful  for  some  old
              SCSI devices. If not set the cddevice of option --device will be used. Default: not
              set

       -r, --ripper number
              CD ripper to use, 0 - dagrab, 1 - cdparanoia, 2 - cdda2wav, 3 -  tosha,  4  -  cdd.
              Because  cdparanoia  and  dagrab are the only rippers in this list that immediately
              fail on data tracks, RipIT can create an error.log if problems are encountered  and
              continues  to  rip  and  encode  without  endless  looping!  Please  use  dagrab or
              cdparanoia, otherwise RipIT might hang while waiting for data tracks.  Default: 1 -
              cdparanoia.

       --ripopt options
              User  definable  options for specific ripper. Quote them if necessary. Default: not
              set.

       --nicerip number
              Set niceness of ripping process, default: 0.

       -Z, --disable-paranoia [number]
              When using dagrab, the number of retries will be set to  3,  with  cdparanoia  this
              option  is  equal  to  the  -Z  option  of  cdparanoia.  The number can be set to 0
              (paranoia on), to 1 (paranoia off) or to 2 to switch paranoia off if a track  fails
              or  gets a timeout. RipIT will retry that failed track without paranoia or give up.
              Ripping will then continue with paranoia on. Default: 0 ‐ off, i. e.  use  paranoia
              mode.

       --ghost
              Analyze  each wav for gaps and split it into chunks if gaps are detected and/or try
              to trim lead-in/out. This may override option merge. Delete blank  tracks  if  only
              silence ("zero bytes") are found. Experimental!  Default: off.

       --extend seconds
              When  using  option --ghost and only if a chunk of sound is detected, enlarge chunk
              by amount of seconds at end if possible, or track may be trimmed if value is  small
              (e.g.  0.3), use with caution. Default: 2.0.

       --prepend seconds
              When  using  option --ghost and only if a chunk of sound is detected, enlarge chunk
              by amount of seconds at beginning, if possible, or track may be trimmed if value is
              small (e.g. 0.3), use with caution. Default: 2.0.

       -c, --coder number
              Encoder(s)  to use, 0 - Lame (for mp3), 1 - Oggenc, 2 - Flac, 3 - Faac, 4 - mp4als,
              5 - Musepack, 6 - Wavpack, 7 - ffmpeg, a comma separated list, or as an array.  The
              same encoder may be stated more than once, but different output-directories must be
              specified stating the --ditemplate for each encoder or using the $quality parameter
              in option --dirtemplate or --tracktemplate. See below. Default: 0.

       --faacopt Faac-options
              Pass  other  options  to the encoder. If the same encoder has been stated more than
              once, use a comma separated list. Quote them with double quotes if needed; default:
              not set.

       --flacopt Flac-options
              Pass  other  options  to the encoder. If the same encoder has been stated more than
              once, use a comma separated list. Quote them with double quotes if needed; default:
              not set.

       --lameopt Lame-options
              Pass  other  options  to the encoder. If the same encoder has been stated more than
              once, use a comma separated list. Quote them with double quotes if needed; default:
              not set.

       --museopt Musepack-options
              Pass  other  options  to the encoder. If the same encoder has been stated more than
              once, use a comma separated list. Quote them with double quotes if needed; default:
              not set.

       --musenc Musepack-encoder
              Choose  Musepack  encoder  to  be used, either mpcenc or mppenc for older versions;
              default: mpcenc.

       --mp4opt Mp4als-options
              Pass other options to the encoder. Option -MP4 of encoder mp4als  is  mandatory  to
              enable  tagging  of  sound  files. Use the appropriate options to alter compression
              level and speed. If the same encoder has been stated more than once,  use  a  comma
              separated list. Quote them with double quotes if needed; default: not set.

       --oggencopt Oggenc-options
              Pass  other  options  to the encoder. If the same encoder has been stated more than
              once, use a comma separated list. Quote them with double quotes if needed; default:
              not set.

       --wavpackopt Wavpack-options
              Pass  other  options  to the encoder. If the same encoder has been stated more than
              once, use a comma separated list. Quote them with double quotes if needed; default:
              not set.

       --ffmpegopt ffmpeg-options
              Pass  other  options  to the encoder. If the ffmpeg has been stated more than once,
              use a comma separated list. Quote them with double quotes if needed;  default:  not
              set.

       --ffmpegsuffix ffmpeg-suffix
              The  suffix of the formats to be encoded. If ffmpeg has been stated more than once,
              use a comma separated list. Quote them with double quotes if needed;  default:  not
              set.

       -q, --quality quality
              A comma separated list of values or the word "off", passed in the same order as the
              list of encoders! If no encoders passed, follow  the  order  of  the  config  file!
              Quality for oggenc: (1-10), highest = 10; compression level for Flac: (0-8), lowest
              compression = 0; quality for Lame in vbr mode: (0-9),  best quality = 0; or quality
              for  Faac:  (10-500),  highest  =  500;  mp4als seems not to accept any compression
              level, set to zero; quality for Musepack:  (0-10),  best  quality  =  10;  default:
              5,3,5,100,0,5.  Wavpack  and  ffmpeg  have  no  quality switch, use encoder options
              instead.  The value "off" turns option quality off.
              E. g. --coder 2,0,1,3 --quality 3,4,5,300 sets compression level  for  Flac  to  3,
              Lame-quality to 4, Oggenc-quality to 5 and Faac quality to 300.

       -v, --vbrmode mode
              Variable  bitrate,  only  used with Lame, mode is new or old, see the Lame manpage.
              The Lame-option quality will be changed to -V instead of -q if  vbr-mode  is  used;
              default: not set.

       -b, --bitrate rate
              Encode  "mp3"  at this bitrate for Lame. If option --vbrmode used, bitrate is equal
              to the -b option, so one might want to set it "off"; or set if "off" if all options
              are passed to --lameopt!  Default: 128.

       -B, --maxrate rate
              maxrate (Bitrate) for Lame using --vbrmode is equal to the -B option in Lame or the
              -M option in Oggenc, default: 0.

       -S, --preset mode
              Use the preset switch when encoding with Lame. Combined with option  --vbrmode  new
              the  preset  fast will be used.  Use --vbrmode old not to use fast VBR. Mode is one
              of: insane (320 kbps @ CBR), extreme (256 kbps), standard (192 kbps) or medium (160
              kbps) or any other valid bitrate. Default: off.

       -W, --chars [list]
              Exclude  special  characters  in file names and path. The argument is optional. The
              argument accepts a list of any characters. One might escape the characters  or  use
              double quotes to pass them on the command line. The argument also accepts the words
              NTFS, HFS or off. Following characters will be erased, if no argument stated or the
              word  NTFS  is passed: |\:*?$  plus blanks and periods at beginning and end of file
              names and directories. When using the word HFS, only colons  will  be  purged  plus
              blanks  and periods at beginning of file names and directories. Pass the word "off"
              as argument to set the option off again. Default: off.

       --comment comment
              Specify a comment  for  the  comment-tag  for  Lame,  Faac  and  Musepack,  or  the
              description-tag  for  Oggenc  and  Flac.  The special comment cddbid or discid will
              place the cddbid (used by freedb) or the discid (used  for  MusicBrainz)  into  the
              comment. Default: not set.

       -g, --genre genre
              Specify  (and  override  CDDB)  genre, must be a valid ID3-genre if using Lame, can
              (but shouldn't) be anything if using other encoders, default: not set.

       -y, --year year
              Specify (and override CDDB) the year of year-tag for Lame, Faac  and  Musepack,  or
              the date-tag for Oggenc and Flac. Default: not set.

       --coverart number
              a  comma  separated  list  of  numbers  (if several encoders are used) according to
              option --coder with values 0 (no) or 1 (yes), default 0.

       --coverpath path
              Path to the coverart picture to be included in the metadata of the sound files. The
              picture  must  be  present or e.g. acquired using the --precmd option. Default: not
              set.

       --mp3tags FRAME=tag
              Additional tags to be added to the mp3 file(s) if  encoder  does  not  support  the
              frame  or if some unofficial FRAMEs shall be used (e.g. a compilation tag set to 1:
              TCMP=1). More than one --mp3tags can be  used  if  several  tags  shall  be  added.
              Default: not set.

       --vatag number
              Analyze  tracknames  for "various artists" style and split the metadata in case one
              of the delimeters (colon, hyphen, slash  or  parenthesis)  are  found.  Use  unpair
              numbers for the scheme "artist ? tracktitle" and pair numbers in the opposite case.
              The artist will be compared to the argument of option --vastring (see  below).   If
              the  artist  must be like --vastring and each track have a delimeter, use 1 (2), if
              the artist must be like --vastring while only some tracks  contain  the  delimeter,
              use  3  (4), if no restrictions apply for the artist but all tracknames must have a
              delimeter, use 5 (6) and finally, if only a few tracks contain a  delimeter  to  be
              used as splitting point, set --vatag to 7 (8). Default: not set.

       --vastring string
              A  string  (regular  expression)  that  defines  the  "various artists" style, e.g.
              Varios|VA. Default: \bVA\b|Variou*s|Various\sArtists

       -D, --dirtemplate '"foo parameters"'
              Use single and double quotes to pass the parameters of the templates!  Allowed  are
              any legal characters, slashes for multi-level directories and following parameters:
              $album, $artist, $iletter, $genre, $quality, $suffix, $trackname, $tracknum,  $year
              and   $trackno;  example:  '"$suffix  $quality/my_snd_dir/$iletter/$artist/$year  ‐
              $album"'.  The parameter $iletter  is  the  initial  letter  of  the  artist  name;
              $trackno  is  the  total  number of tracks of the release, this might be helpful to
              distinguish different releases with exactly the same name; $quality is  needed,  if
              one  wants  to  encode the same format at different qualities in the same run. Note
              that $quality reflects  the  encoder  options  and  not  the  arguments  of  option
              --quality  which might be set to "off". Or state different dirtemplates: the option
              is an array, so one can use several different dirtemplates in the same order as the
              encoders.  If less dirtemplates than encoders are stated, the last dirtemplate will
              be used  for  subsequent  encoders  and  the  wav-directory,  see  EXAMPLES  below.
              Default: '"$artist - $album"'.

       -T, --tracktemplate '"foo parameters"'
              See  above.  The  tracktemplate  is not an array, only one can be stated.  Default:
              '"$tracknum $trackname"'.

       --trackoffset number
              Give a trackoffset to be added to the $tracknum variable (see above).  Default: 0.

       --sshlist list
              Comma separated list of remote machines where RipIT should encode. The output  path
              must  be  the  same for all machines. Specify the login (login@machine) only if not
              the same for the remote machine. Else just state the machine  names.  See  EXAMPLES
              for more information, default: not set.

       --scp  If  the  file system can not be accessed on the remote machines, scp (copy) the WAV
              files to the remote machines, default: off.

       --local
              Only used with option --sshlist; if all encoding shall be done on remote  machines,
              use --nolocal, default: on.

       --mb   Access  MusicBrainz  DB  via  WebService::MusicBrainz  module  instead  of the http
              protocol (see below). One needs the discid calculation perl module or command to be
              installed  and  in  the  path. Negate to switch option off again. A non interacitve
              freedb lookup will be done to retrieve a genre. Default: off.

       --mbname login
              Give the users MusicBrainz login name to submitt ISRCs to the  database.  Saved  in
              plain when using a config, default not set.

       --mbpass password
              Give  the  users  MusicBrainz  password  to submitt ISRCs to the database. Saved in
              plain when using a config, default not set.

       --isrc number
              Enable ISRC detection with number = 1 (using icedax) and submission to MusicBrainz;
              default: 0

       -C, --cddbserver server
              CDDB   server,   either   freedb.org,   freedb2.org  or  musicbrainz.org.   Default
              freedb.org. Note, the full  address  is  "mirror".freedb.org,  i.  e.   default  is
              freedb.freedb.org.  Exception:  freedb2.org  and  musicbrainz.org  have no mirrors,
              their full addresses are: freedb2.org and freedb.musicbrainz.org on  port  80  (see
              transfer mode).

       -t, --transfer mode
              Transfer  mode,  cddb  or  http,  will  set  default port to 8880 or 80 (for http),
              default:  cddb.  Note:  use  http   mode   with   CDDB   servers   freedb2.org   or
              musicbrainz.org.

       -m, --mirror mirror
              Choose  "freedb"  or  one of the possible freedb mirrors, default: freedb. For more
              information check  the  webpage  www.freedb.org.   There  is  no  list  of  mirrors
              available  these days. This option might be obsolete as freedb uses random servers,
              but the default setting is mandatory.

       -L, --protocol level
              CDDB protocol level for CDDB query. Level = 6 supports UTF-8 and level = 5 not. Use
              level = 5 to suppress UTF-8. Cf. option --utftag below. Default: 6.

       -P, --proxy address
              The  http  proxy  to  use when accessing the cddb server. The CDDB protocol must be
              http! Default: not set.

       -n, --nice number
              Set niceness of encoding process, default: 0.

       -a, --archive
              Read and save CDDB files in $HOME/.cddb/"category" directory, where the  "category"
              is one of the 11 CDDB categories. Default: off.

       -e, --eject
              Ejects  the  CD  when finished, if hardware supports it. Use --noeject to switch it
              off. Default: off.

       --ejectcmd command
              Command to be used for ejection or loading of CD tray. Should be  specified  within
              FreeBSD even if option --eject is not used to enable RipIT to load the CD tray. One
              does not need to mention the words close or eject or options like  -t,  RipIT  does
              it. Default: eject.

       --ejectopt options
              Options  for  ejection  command  to  be  used  for  ejection or loading of CD tray.
              Default: the path to the CD device.

       --halt Powers off the machine when finished if configuration supports it, default: off.

       -s, --submission
              Specify --nosubmission if the computer is offline and  the  created  file  cddb.toc
              shall  be  saved  in  the  home  directory  instead of being submitted. With option
              --archive it will also be saved in the $HOME/.cddb directory. Note:  it  is  really
              easy  to resubmit incomplete CDDB entries! One can confirm each existing field with
              Enter and add a missing genre or year. The purpose of this option is also to permit
              the  user  to  edit the CDDB data for the own filenames & tags and not to overwrite
              the original CDDB entry! Default: on.

       -M, --mail address
              Users return email address, needed for submitting an entry to freedb.org.  Default:
              not set.

       -p, --playlist number
              Create the m3u playlist file, or use --playlist 0.  For filenames without full path
              use --playlist 2.  Default is full path for filenames. Default 1 - on.

       -A, --book number
              Create an audiobook file, i. e. merge all  tracks  into  one  sinlge  file,  option
              --ghost  will be switched off and file suffix will be m4b instead of m4a. Make sure
              to use encoder faac, ripit will not check  for  the  encoder  used.  The  installed
              version  must  support  the -w option to write tags. A chapter file will be written
              for chapter marks. Default: off.

       -i, --interaction
              Specify --nointeraction if ripit shall take the first  CDDB  entry  found  and  rip
              without any questioning. Default: on.

       --lcd  Use lcdproc to display status, default: not set.

       --lcdhost
              Specify the lcdproc host, default: localhost.

       --lcdport
              Specify the lcdport, default: 13666.

       --infolog file
              Log  operations  (system  calls,  file/directory  creation) to file given with full
              path; default: not set.

       -l, --lowercase
              Lowercase filenames, default: off.

       -u, --underscore
              Use underscores (_) instead of spaces in filenames, default: off.

       --uppercasefirst
              Uppercase first letter of each word in filenames and tags. Use this option  if  the
              CDDB entry is uppercase only. Default: off.

       -U, --utftag
              Keep  Lame-tags  in  UTF-8  or  decode  them  (but not the filenames) from UTF-8 to
              ISO8859-1. Applies only to  mp3  (Lame).  May  be  useful  for  tags  with  special
              characters  and  if  mp3-player  doesn't support Unicode.  Using Musepack one might
              want to pass the Musepack option --unicode to option museopt.  Default: off.

       --rip  Rip the CD, to be used as --norip if wav-files are  present.  Used  for  debugging.
              Default: not set.

       --encode
              Do  encode  the wavs. If only the wav-files shall be created, prevent encoding with
              --noencode (and use option --wav, see below). Default: on.

       -w, --wav
              Keep the wav files after encoding instead of deleting them, default: off.

       -N, --normalize
              Normalizes the wave-files to a given dB-value (default: -12dB). Default: off.
              This is useful when encoding

              *  for hardware or software that doesn't support the replaygain‐feature

              *  to audio formats without replaygain capabilities.

       --normcmd
              Command to use for normalizing, default: normalize.

       -z, --normopt
              Options to pass to normalize.  Possible values:

                  -a -nndB   :   Normalize to -nn dB, default is -12dB,
                  Value range:   All values <= 0dB
                  Example    :   normalize -a -20dB *.wav
                  -b         :   Batch mode ‐ loudness differences between
                                 individual tracks of a CD are maintained
                  -m         :   Mix mode ‐ all track are normalized to the
                                 same loudness
                  -v         :   Verbose operation
                  -q         :   Quiet operation

              For further  options  see  normalize  documentation  (http://normalize.nongnu.org).
              Please  note  that  normalizing  to a high dB value, e.g. -6dB or less will lead to
              severe compression of the audio signal, thus  losing  sound  quality.  Keeping  the
              default value of -12dB is recommended.
              Default: -b Option v (q) will be set according to verbosity chosen.

       --cdtoc number
              Number  n  =  1  to create a toc file to burn the wavs with CD-Text using cdrdao or
              cdrecord. Default: off.

       --inf number
              Number n = 1 to create inf files to burn the  wavs  with  CD-Text  using  wodim  or
              cdrecord. Default: off.

       --cdcue number
              Number  n  =  1  or  2 to create cue sheets to burn the wavs with CD-Text.  The cue
              sheets will be copied to the other file formats. Number 1 will swith option --ghost
              on  to  eliminate  chunks  of silence. Number 2 is experimental but does not switch
              option --ghost on and may be used if number 1 fails.  Default: off.

       -h, --help
              Print this and exit.

       -V, --version
              Print version and exit.

       -x, --verbose number
              Run silent (do not output comments, status etc.) (n = 0), with minimal output (n  =
              1),  normal  without  encoder  messages  (n  = 2), normal (n = 3), verbose (n = 4),
              extremely verbose (n = 5).  Default 3.

       --config
              Read parameters from config file or specify --noconfig to  prevent  reading  it.  A
              local  config  file  in  $HOME/.ripit/ will have higher priority, only if the local
              file does not exist, ripit will try to read /etc/ripit/config. Default: on.

       --save Add parameters passed on command line to an existing config  file.  This  does  not
              overwrite  other  existing  settings.  Options  of  an existing config file will be
              adopted and the old file saved as config.old.  Default: off.

       --savenew
              Save all parameters passed on command line to a new config file, backup an existing
              file  to  config.old.  Creates  a  default  config file if no options are passed on
              command line. Default: off.

       --loop value
              Continue ripping and encoding as soon as the  previous  CD  finished.  This  option
              forces  ejection  (--eject). The value is either 0 for normal use or 1 for standard
              looping. Experimental value 2 migth be used to force immediate restart  of  ripping
              process.   This  will  spoil the output, this will show the prompt although a child
              process is running (waiting for a new CD) and must be terminated manually. Default:
              off.

       --quitnodb value
              Give  up  CD if no CDDB entry found. Useful if option --loop or --nointeraction are
              on. Default behaviour is to let operator enter data or to use default artist, album
              and track names. Possible values: 0 - off, 1 - on, default: off

       --resume
              Resume a previously started session. Default: off.

       -O, --overwrite argument
              Default  behaviour of Ripit is not to overwrite existing directories, a suffix will
              be added if directory name exists. Use option overwrite to prevent this and  either
              overwrite a previous rip (y) or force Ripit to quit (q) or even eject the disc (e).
              If ejection is chosen, the disc will be ejected even if option --eject has not been
              switched on. Default: off (n)

       --dpermission number
              Change the directory permission to number. Default: 0755.

       --fpermission number
              Change the file permission to number. Default: 0644.

       --md5sum
              Create a MD5-sum file for each type of sound files.

       --threads number
              Comma  separated  list  of numbers giving maximum of allowed encoders to run at the
              same time. In conjunction with option sshlist the number for the local  machine  is
              mandatory and must be stated first.  Default: 1.

       -X, --execmd command
              State  a  command  to  be executed when ripit finshed. The same variables as in the
              dirtemplate can be stated. When using MusicBrainz one can try to use  $cd{asin}  to
              get the ASIN. Make sure to escape the command if needed. Default: not set.

       --precmd command
              State a command to be executed before ripping started. The same variables as in the
              dirtemplate can be stated. When using MusicBrainz one can try to use  $cd{asin}  to
              get  the  ASIN. Make sure to escape the command if needed. Can be used to execute a
              script to retrieve coverart.  Default: not set.

EXAMPLES

       To specify a CD device, type

              ripit --device /dev/sr1

       To specify the output directory, type

              ripit --outputdir /foo/paths/

       To rip and encode a special track selection, type

              ripit 1,3-6,8-11

       To use several encoders in the same run, type

              ripit --coder 1,0,2 --quality 3,5,6

       To use Lame with variable bitrate (VBR), type

              ripit --vbrmode new --bitrate 0

       Note, one should reset the --bitrate to 0 (zero) if the -b option of Lame is not  desired.
       According to VBR mode in Lame, use "new" or "old".

       It  is  recommended  to  use the preset switches for Lame, (see Lame man-page) and specify
       fast encoding with --vbrmode new (use --vbrmode old to switch off the fast encoding)

              ripit --preset extreme --vbrmode new

       To pass options related to the encoder use the according encoder option  switch:  e.g.  to
       use the managed mode with oggenc:

              ripit -c 1 --oggencopt "--managed -b 192 -M 224 -m 96" --quality "off"

       Normalize your wave-files prior to encoding:

              ripit --normalize

       Normalize your files to -18dB using "mix mode" (see normalize documentation)

              ripit --normalize --normopt "-m -a -18dB"

       To define a directory template where the sound files should  go, type

              ripit --dirtemplate '"$artist - $year"'

       To create 2 directory levels, as used in other environments, type

              ripit --dirtemplate '"$artist/$album"'

       To save a config file in ~/home/.ripit/ with options: to use Lame and Oggenc, don't create
       a m3u file, archive the CDDB entry files in ~/.cddb/"category"/ and to eject CD when done,
       type

              ripit --coder 0,1 --playlist 0 --archive --eject --save

       To do the job without any interaction, type

              ripit --nointeraction

       To use a network for encoding, make sure that the output paths are equal on all machines!

              ripit --sshlist sun,saturn,earth

       where  sun, saturn and earth are remote machines on which a user can login via ssh without
       entering a password or passphrase! Note that the paths must be equal for the user  on  all
       remote machines!  If the login is different on some machines, try

              ripit --sshlist login1@sun,login2@saturn,login3@earth

       If  there  is  "no"  identical path on the remote machines, then the user might enter e.g.
       /tmp/ as output directory.  If the file-system is not mounted on each remote machine,  one
       can try to copy the wavs to the remote machines using option --scp.

              ripit --sshlist sun,saturn,earth --scp

       Check for ghost songs and trim very long lead-in/out:

              ripit --ghost --prepend 1.0 --extend 1.0

       Rip only first 30 seconds of each track (useful for testing)

              ripit --span 0-30

       Encode  the same format in 2 qualities, at low quality for a portable, at high quality for
       home:

              ripit --dirtemplate '"cbr/$artist/$year ‐ $album"' \
                    --dirtemplate '"preset/$artist ‐ $album"' \
                    --coder 0,0 --bitrate off --quality off,off \
                    --lameopt "-b 128 -q 2;--preset extreme"

       Force RipIT to use one and the same directory for all sound files:

              ripit --dirtemplate '"/"' --outputdir="/media/sound" \
                    --resume

FILES

       User config file (/etc/ripit/config will only be used if there is no $HOME/.ripit/config):

              $HOME/.ripit/config
              /etc/ripit/config

              /usr/share/doc/packages/ripit/README
              /usr/share/doc/packages/ripit/HISTORY
              /usr/share/doc/packages/ripit/LICENSE

BUGS

       Probably there are more than some.

SEE ALSO

       cdparanoia(1), lame(1), oggenc(1), flac(1), normalize(1), cdda2wav(1), ffmpeg(1)

AUTHORS

       RipIT  is  now  maintained  by  Felix  Suwald,  please  send  bugs,  wishes  comments   to
       ripit_[at]_suwald_[dot]_com with a concise subject.
       For bugs, wishes and comments about lcdproc, please contact
       max.kaesbauer_[at]_gmail_[dot]_com.
       Former  maintainer:   Mads  Martin  Joergensen;   RipIT  was originally developed by Simon
       Quinn.

       This manpage was originally created for the Debian GNU/Linux system by help2man  1.36  and
       optimized by Elimar Riesebieter <riesebie@lxtec.de>, enhanced and updated by Felix Suwald.