ripit man page on DragonFly

Man page or keyword search:  
man Server   44335 pages
apropos Keyword Search (all sections)
Output format
DragonFly logo
[printable version]

RIPIT(1)		     RipIT audio converter		      RIPIT(1)

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  WebSer‐
       vice::MusicBrainz.pm from MusicBrainz.org.

       It is possible to submit and edit CDDB entries at  freedb.org,  submis‐
       sion  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 rip‐
       ping 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  cdpara‐
	      noia. The hyphen is mandatory.  The format of start and end-time
	      is according to  cdparanoia  hh:mm:ss.ff	in  hours/minutes/sec‐
	      onds/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 rip‐
	      pers in this list that immediately fail on  data	tracks,	 RipIT
	      can  create an error.log if problems are encountered and contin‐
	      ues 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 neces‐
	      sary. 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 speci‐
	      fied 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 appropri‐
	      ate  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 dou‐
	      ble 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 compres‐
	      sion  =  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 --vbr‐
	      mode 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 peri‐
	      ods 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	Musep‐
	      ack,  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 seperated 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  tem‐
	      plates!	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	$qual‐
	      ity/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 dirtem‐
	      plates 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. Spec‐
	      ify  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  calcula‐
	      tion  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 submis‐
	      sion 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	 "mir‐
	      ror".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 --noe‐
	      ject 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 cre‐
	      ated 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	resub‐
	      mit 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	 file‐
	      names  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 sup‐
	      port 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 use‐
	      ful  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, pre‐
	      vent 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://normal‐
	      ize.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 cho‐
	      sen.

       --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 pre‐
	      vent 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 fin‐
	      ished. 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. Pos‐
	      sible 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 directo‐
	      ries,  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  documen‐
       tation)

	      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 com‐
       ments 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.

ripit				July 14th, 2010			      RIPIT(1)
[top]

List of man pages available for DragonFly

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net