[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.
To rip only audio tracks and to skip all data tracks (trailing or even in between) the tweeked
argument 1-a might be useful. In this case Ripit will try to detect the number of audio tracks
using cdparanoia toc query.
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. Do not use
this option to merge the whole disc into one track, use option --cdcue or --book instead.
Default: not set.
-I,--span starttime-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 if no minutes and
hours are stated. When using cdda2wav this option translates the values to the -o and -d options
of cdda2wav. When using option merge, end time is related to the last track in the selection.
Default: not set.
-o,--outputdirdir
Full path of directory where the sound should go. If not set, $HOME will be used. Default: not
set.
-d,--devicecddevice
Path of the device containing the audio CD, default: /dev/cdrom.
--scsidevicecddevice
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,--rippernumber
CD ripper to use, 0 - dagrab, 1 - cdparanoia, 2 - cdda2wav, 3 - rip (Morituri) (breaking
parallelism, experimental), 4 - cdd (support not ensured). When data tracks are encountered
because special track selection 1-a has not been used, cdparanoia and dagrab are supposed to
immediately fail and therefore allow Ripit to create an error.log so that the encoder process can
terminate if problems were encountered. This might not be the case depending the type of
"copyprotection" is used and on the other hand it could be that cdd2wav may fail on such data
tracks and enables Ripit to continue to rip and encode without endless looping. Use the
appropriate ripper according to your needs and switch the ripper if needed or use the special
track selection to omit data tracks.
Note when using rip (Morituri) alle directories must be defined with option --dirtemplate,
including a separate wav directory which will be created by rip (Morituri). Further inconveniences
might be due to the programs limitations and its recent development activity with behaviour
changing almost dayly, breaking every wrappers capabilities.
Default: 1 - cdparanoia.
--ripoptoptions
User definable options for specific ripper. Quote them if necessary. Note that changing the ripper
implies to update this option. Default: not set.
--offsetnumber
User definable sample offset for the CD ripper. This will trigger option -O when using cdparanoia
and option -o when using rip (Morituri). Icedax (cdda2wav) seems not to provide a sample offset.
Default: not set.
-Q,--accuracy number
Check ripped files at AccurateRip using Morituri (rip) which must be installed. One might need to
specify a sample offset (see option --offset) to achieve accuracy. Default: off.
-Y,--verifynumber
When using cdparanoia rip track number times until md5sum for 2 rips match, maximum tries is the
number given as argument, default: 1, i.e. no checks will be done.
--niceripnumber
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.
--extendseconds
When using option --ghost and only if a chunk of sound is detected, enlarge chunk by amount of
seconds at end if possible (no silence will be added), or track may be trimmed if value is small
(e.g. 0.3), use with caution. Default: 2.0.
--prependseconds
When using option --ghost and only if a chunk of sound is detected, enlarge chunk by amount of
seconds at beginning, if possible (no silence will be added), or track may be trimmed if value is
small (e.g. 0.3), use with caution. Default: 2.0.
-c,--codernumber
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 (to prevent overwriting files with
identical path) stating the --dirtemplate for each encoder or using the $quality parameter in
option --dirtemplate or stating the --tracktemplate for each encoder. 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. Do not use this option for compression level, use option --quality instead. 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. Do not use this option for compression level, use option --quality instead. Quote
them with double quotes if needed; default: not set.
--flacdecopt Flac decoding options
Additional options for flac when used to decode flac files. Might be needed to force (over)
writing existing wav files: Default: -s (silent).
--lameopt Lame-options
Pass other options to the encoder. If the same encoder has been stated more than once, use a comma
separated list. Do not use this option for quality settings, use option --quality instead. 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. Do not use this option for quality settings, use option --quality instead. 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. Do not use this option for quality settings, use option --quality instead. 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,--qualityquality
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. This options name might be
misleading as lossless encoders do not have a quality but a compression level instead. Depending
the encoder it refers, this option means: quality for oggenc: (1-10), highest = 10; compression
level for Flac: (0-8), lowest (but fastest) 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, if supported by the encoder. Encoders that need a quality or
compression level will use default value in case "off" is used.
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,--vbrmodemode
Option vbrmode defines variable-bitrate, only used with Lame, the mode is either 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,--bitraterate
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,--maxraterate
Option maxrate (bitrate) for Lame when using --vbrmode is translated to the -B option in Lame or
the -M option in Oggenc, default: 0.
-S,--presetmode
Use the preset switch when encoding with Lame. Combined with option --vbrmodenew the "preset
fast" setting will be used. Use --vbrmodeold 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 presets 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.
--commentcomment
Specify a comment for the comment-tag for Lame, Faac, Musepack and Wavpack, 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. See also option --mp3tags, --flactags or
--oggtags for more special tags to be added; default: not set.
-g,--genregenre
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,--yearyear
Specify (and override CDDB) the year of year-tag for Lame, Faac, Musepack and Wavpack or the date-
tag for Oggenc and Flac; default: not set.
--coverartnumber
A number or comma separated list of numbers (if several encoders are used) according to option
--coder with values 0 (no) or 1 (yes); default 0.
--coverpathpath
Path to the coverart picture to be included in the metadata of the sound files. The picture must
be present or acquired using e.g. the --precmd option to call a specific script taking care of the
process finding coverart or option --coverorg in combination with option --mb (see below). This
option is mandatory in case --coverart is used. The full path might be given with variables
according to the --dirtemplate and using same quoting rules. Absolutely no checks about existence
of path will happen and a missing path will not be created so that a wrong argument might lead to
failed downloads when using --coverorg. No checks about existence of coverart will be done if
--interaction is set off. In case of re-encoding the variable $inputdir can be stated. Default:
not set.
--coverorgnumber
Retrieve coverart from coverartarchive.org using the MusicBrainz release ID (not to be confused
with the discid, used to find the release on MusicBrainz). Furthermore as an experimental feature
discogs.com will be used in case a discogs release ID was listed on the MusicBrainz release page.
But this might be out of order any time as discogs changes page layout frequently. If a cover is
downloaded from coverartarchive.org all other files will get suffixes in their file names not to
overwrite any files. Note that the --coverpath must be set to save the coverart and must reflect
an existing path. Possible values 0 (no) or 1 (yes), default 0.
--coversizeformat
Resize the provided coverart picture to a fix value according to ImageMagicks convert command,
either values in the format XXXxYYY or only a width to keep aspect ratio. The original coverart
file will be renamed. Possible values: any valid format, default: not set.
--copycoverpath
Full path to any kind of file (e.g. the coverart picture) to be copied into all directories
containing encoded files. The argument might consist of variables according to the --dirtemplate
and using same quoting rules. In case of re-encoding the variable $inputdir can be stated,
default: not set.
--flactagsFRAME=tag
Additional tags for flac not passed by the encoder to ensure evaluation of special tags similar to
mp3tags. Use option --flacopt "--tag=FRAME=foo" for additional hard coded tags instead. When
using MusicBrainz additional metadata provided can be added as tags using the scheme FRAME=frame.
Supported are ASIN, BARCODE, CATALOGNUMBER (using tag "catalog"), CDDID, DGID, DISCID aka
MUSICBRAINZ_DISCID (using tag "discid") and MBREID aka MUSICBRAINZ_ALBUMID (using tag mbreid) with
the tag in lower case, e.g. adding an asin: --flactags=ASIN=asin will evaluate the lower case asin
if the variable is defined. Nothing is added if the metadata is not available. The option is an
array, for each additional frame/tag to be added state the option once. Default: not set
--mp3tagsFRAME=[DESCRIPTION]tag
Additional tags to be added to the mp3 file(s) if encoder does not provide options for the FRAME
or if some unofficial FRAMEs shall be used (e.g. a compilation tag set to 1: TCMP=1). This option
only supports basic (id3v2.4) frames in the format FRAME=tag (e.g.
WCOP=http://id3.org/id3v2.4.0-frames) or FRAME=[DESCRIPTION]tag (e.g. a user defined text
annotation for the description ASIN: TXXX=[ASIN]B003ZYEQ30). Note that the braces must be stated
with some content and do not stand for optional content. More than one --mp3tags statement can be
used if several tags shall be added. Do not add a COMM frame here as this tag is supported by
(older versions of) Lame and the corresponding option exists in Ripit. The same goes for the APIC
frame which has its own option in Ripit. Newer versions of Lame may support this tags using Lame
option --tv to be passed with Ripits option --lameopt.
No checks on encoding will happen on content stated here, in case option --utftag is switched off
operator has to ensure encoding of the tags.
Special tags will be evaluated in case the metadata is provided e.g. when using MB and the TXXX
tag. Supported are ASIN, CATALOG, BARCODE, CDDBID, DGID, DISCID aka "MusicBrainz Disc Id" and
MBREID aka "MusicBrainz Album Id" with the tag in lower case, e.g. --mp3tags TXXX=[ASIN]asin will
replace asin with the value if the variable is defined. Default: not set.
--oggtagsFRAME=tag
Additional tags for ogg files similar to --flactags. Default: not set.
--vatagnumber
Analyze track names for "various artists" style and split the metadata in case one of the
delimiters (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 delimiter, use 1 (2), if the artist must be like --vastring while only some tracks contain
the delimiter, use 3 (4), if no restrictions apply for the artist but all track names must have a
delimiter, use 5 (6) and finally, if only a few tracks contain a delimiter to be used as splitting
point, set --vatag to 7 (8). Default: not set.
--vastringstring
A string (regular expression) that defines the "various artists" style, e.g. Varios|VA. Default:
\bVA\b|Variou*s|Various\sArtists|Soundtrack|OST
-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 might be 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,
but must be defined for all formats including wav in case rip (Morituri) is used. Default:
'"$artist - $album"'.
-T,--tracktemplate '"foo parameters"'
See above. The tracktemplate is not an array, only one can be stated. Additionally it allows two
more variables helpful in case VA-style is detected: $trackartist,$tracktitle; note: trackartist
will be filled with the value of artist in case no track artist has been found to respect the
templates settings, and tracktitle will hold the pure trackname. Additional album-artist tags will
be written, e.g. TPE2 tag for Lame and the artist field will contain the track artist tag.
Default: '"$tracknum $trackname"'.
--trackoffsetnumber
Give a trackoffset to be added to the $tracknum variable (see above). Might be useful to join
multi disc releases into one directory (and to switch option --overwrite to "y"). Default: 0.
--addtrackoffset
When using MusicBrainz, check for multi discs releases and automatically add a calculated
--trackoffset to the track counter. Ripit will try to detect already ripped multi disc releases
and temporarily switch option --overwrite to "y" in case the first track of a multi disc release
is not present in an existing directory corresponding to the dirtemplate.
Negate to switch option off again. Default: not set.
--discnonumber
Set a counter for the disc when using a multi disc release. This option accepts any integer; when
using MB and --discno is set to 1 the discnumber will be set to the discnumber according to the
presented data (read as: switch option on). Using a number > 1 will force this number and will not
be altered if MB gives a different disc number. Default: 0.
--sshlistlist
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 freedb (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 interactive freedb look-up will be done to retrieve a genre. Default: off.
--mbrelsnumber
Check each track for additional relationships, only vocal and work relationships are handled.
Possible values 0 (no) or 1 (yes); default: 0.
--mbnamelogin
Give the users MusicBrainz login name to submit ISRCs to the database. Saved in plain when using
a config, default: not set.
--mbpasspassword
Give the users MusicBrainz password to submit ISRCs to the database. Saved in plain when using a
config, default: not set.
--isrcnumber
Enable ISRC detection with number = 1 (using icedax) and submission to MusicBrainz. Note that
option --mb must be switched on. Possible values 0 (no) or 1 (yes); default: 0.
--cdtextnumer
Check for CD text if no DB entry found, possible values 0 (no) or 1 (yes); default 0; default: 0
-C,--cddbserverserver
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,--transfermode
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,--mirrormirror
Choose "freedb" or one of the possible freedb mirrors, default: freedb. For more information check
the web page 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,--protocollevel
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,--nicenumber
Set niceness of encoding process, default: 0.
-a,--archive
Read and/or save CDDB files in $HOME/.cddb/"category" directory using the xmcd format, where the
"category" is one of the 11 CDDB categories or in case MusicBrainz is used an additional category
"musicbrainz" will be used. Default: off.
-e,--eject
Ejects the CD when finished, if hardware supports it. Use --noeject to switch it off. Default:
off.
--ejectcmdcommandCommand 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.
--ejectoptoptionsOptions 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. The purpose of this option is also to permit the user to edit the CDDB data
for the own track names & tags and not to overwrite the original CDDB entry. Default: on.
-M,--mailaddress
Users return email address, needed for submitting an entry to freedb.org. Default: not set.
--mailoptoptions
Additional options, added to sendmail command. The reply-to address will be used with option -r as
defined above. Default: -t
-A,--booknumber
Create an audiobook file, i. e. merge all tracks into one single file, option --ghost will be
switched off.
If encoder faac is used file suffix will be m4b instead of m4a and a chapter file will be written
for chapter marks. The installed version of faac must support the -w option to write tags.
Note that options --wav and --cdtoc should also be switched off. Possible values 0 (off) or 1
(on); default: off.
--cdcuenumber
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 switch 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.
--cdtocnumber
Number n = 1 to create a toc file to burn the wavs with CD-Text using cdrdao or cdrecord. Default:
off.
--infnumber
Number n = 1 to create inf files to burn the wavs with CD-Text using wodim or cdrecord. Default:
off.
-p,--playlistnumber
Create the m3u playlist file, or use --playlist0. For file names without full path use
--playlist2. Default is full path for file names. Default 1 - on.
-i,--interaction
Specify --nointeraction if ripit shall take the first 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.
--infologfile
Log operations (system calls, file/directory creation) to file given with full path; default: not
set.
-l,--lowercasenumber
Lowercase file names and or directories (from tracktemplate and dirtemplate): number n = 0, off,
1, on for file names and directories, 2, only for file names, 3, only for directories, default:
off.
-u,--underscore
Use underscores (_) instead of spaces in file names, default: off.
--uppercasefirst
Uppercase first letter of each word in file names 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 file names) 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. Note that combining with options --threads (and or --sshlist) may lead to issues and must
be regarded as experimental. Default: off.
--rip Rip the CD, to be used as --norip if wav (or flac) files are present. Previously used for
debugging, may be useful to re-encode existing wav or flac files in a given --inputdir (see
below). Option --inputdir is mandatory in case --norip is used. Default: not set. Note: this
option can not be defined in the config file.
--inputdirdirectory
Full path to the directory with wav or flac files to be re-encoded using option --norip. See also
option --cdid to get awereness on some unexpected behaviour. Default: not set. Note: this option
can not be defined in the config file.
--cdidid
Give a freedb.ord CDDBID or a musicbrainz discid in case lookup shall be done when re-encoding wav
or flac files and existing track names (of wavs) or tags (in flac files) should be updated when
using --norip. If not stated, ripit will try to detect an ID in playlist, toc or log files or cue
sheets to retrieve local or online metadata. This means: a look-up may happen even if this option
is not stated. This may lead to some unexpected effects, e.g. differing directory or track names
from those stated in option --inputdir, new tracknumbers in case ghost songs are present, merged
multi disc releases and so on. Default: not set. Note: this option can not be defined in the
config file.
--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.
-h,--help
Print this and exit.
-V,--version
Print version and exit.
-x,--verbosenumber
Run silent (do not output comments, status etc.) (number 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.
--confname
Read parameters from a specific configuration file if special options are needed, this might be
useful if operator wants different settings for discs containing music than e.g. audio books.
Default: config.
--confdir
Read parameters from a config file in a specific directory, default is $HOME/.ripit/.
--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 no matter if a file named config.old already exists. Default: off.
--savenew
Save all parameters passed on command line to a new config file, backup an existing file to
config.old no matter if a file named config.old already exists. Creates a default config file if
no options are passed on command line. Default: off.
--loopvalue
After ejection of the previous CD continue ripping and encoding as soon as a new CD has been fed.
This option forces ejection (--eject). The value is either 0 for normal use (single run) or 1 for
(standard) looping. Experimental value 2 might be used to force immediate restart of the ripping
process even if encoder did not yet complete. 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
explicitly.
The config file will be read out on each run just before ejection of the disc. In case one alters
the config file after ejection, close the tray with the disc already done for re-reading the
config and re-ejection of the disc. Therefore it might be useful to pass as few options as
possible on the CL when using option --loop, because options passed on the CL can of course not be
alterd with the config file during a loop.
Default: off.
--quitnodbvalue
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,--overwriteargument
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)
--dpermissionnumber
Change the directory permission to number. Default: 0755.
--fpermissionnumber
Change the file permission to number. Default: 0644.
--md5sum
Create a MD5-sum file for each type of sound files.
--threadsnumber
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,--execmdcommand
State a command to be executed when ripit finished. The same variables as in the dirtemplate can
be stated. When using MusicBrainz one can try to use $cd{asin} to pass the ASIN to the command to
be executed. Make sure to escape the command if needed. Default: not set.
--precmdcommand
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 e.g. to use $cd{asin} to pass the ASIN to the
command to be executed, which might be useful when executing a script to retrieve coverart from a
site. Make sure to escape the command if needed. Default: not set.
Install Now
PNG Icons
Emojis