Linux Certif

Toute la documentation sur la certification Linux LPI

ripit

NAME:

ripit - Perl script to create .flac .ogg .mp3 or .m4a (aac) files from an audio CD.

SYNOPSIS:

ripit [options]

DESCRIPTION:

This Perl script makes it a lot easier to create "mp3" files from an audio CD. RipIT supports Flac, Lame, Oggenc and Faac. It tries to find the artist and song titles with the CDDB_get.pm. One can submit and edit CDDB entries @ freedb.org. Hidden tracks and ghost songs are detected and splitted into chunks of sound, a toc (cue) file permits to burn the wavs with text and no gaps in DAO mode.

VERSION:

RipIT Version 3.6.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 tracknumber to be merged. Separate several intervals with commas. Default: not set.

-o, --outputdir dir

Where the sound should go, default: not set.

-d, --device cddevice

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

-r, --ripper number

CDripper 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 code without endless looping! Please use dagrab or cdparanoia except if you know what you're doing (know that you will wait)! 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

When using dagrab, the number of retries will be set to 3, with cdparanoia this option is equal to the -Z option. Default: off.

--ghost

Analyze each wav for gaps and split it into chunks if gaps are detected. Default: off.

--extend seconds

Enlarge chunk by amount of seconds at end, if possible. Default: 6.

--prepend seconds

Enlarge chunk by amount of seconds at beginning, if possible. Default: 6.

-c, --coder number

Encoder(s) to use, 0 - Lame, 1 - Oggenc, 2 - Flac, 3 - Faac, a comma separated list. Default: 0.

--faacopt Faac-options

Pass other options to the encoder, quote them with double quotes if needed; default: not set.

--flacopt Flac-options

Pass other options to the encoder, quote them with double quotes if needed; default: not set.

--lameopt Lame-options

Pass other options to the encoder, quote them with double quotes if needed; default: not set.

--oggencopt Oggenc-options

Pass other options to the encoder, 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; default: 5,3,5,100. 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. Lame-quality may be omitted, if constant-bitrate is used. In vbr-mode it assumes the lame-default value of 5.

-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", 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 otpion --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 and (ending!) periods in file names. The argument is optional. Following characters will be erased, if no argument stated: :*#?$! else only ending periods and all passed ones. Pass the word "off" as argument to set it off again. One might escape the characters or use double quotes to pass them on the command line. Default: off.

--comment comment

Specify a comment for the comment-tag for Lame and Faac, or the description-tag for Oggenc or Flac. 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 and Faac, or the date-tag for Oggenc and Flac. Default: not set.

-D, --dirtemplate '" foo parameters "'

Use single AND double quotes to pass the parameters of the templates! Allowed are following parameters: $album, $artist, $genre, $trackname, $tracknum and $year; e. g. '"$artist - $year"'. Default: '"$artist - $album"'.

-T, --tracktemplate '" foo parameters "'

See above, default: '"$tracknum $trackname"'.

--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 informtation, default: not set.

--scp

If the filesystem can not be accessed on the remote machines, copy the wavs to the remote machines, default: off.

--local

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

-t, --transfer mode

Transfer mode, cddb or http, will set default port to 8880 or 80 (for http), default: cddb.

-C, --cddbserver server

CDDB server, default freedb.org. Note, the full address is "mirror".freedb.org, i. e. default is freedb.freedb.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 obsolet 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.

-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.

-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. Default: off.

--rip

Rip the CD, to be used as --norip if wav-files are present. This might be useful to encode the same format in different qualities. 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.

-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: -bv

--cdtoc number

Number n = 1 to create a toc (cue) file to burn the wavs with CD-Text using cdrdao. 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 msgs ( n = 2), normal ( n = 3), verbose ( n = 4), extremly verbose ( n = 5). Default 3.

--config

Read parameters from config file or specify --noconfig to prevent reading it; default: on.

--save

Add parameters passed on command line to config file. This option does not overwrite other settings. An existing config file will be 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. Default: off.

--loop

Continue ripping and encoding as soon as a new CD is inserted. This option implies that the CD is ejected when done (--eject).
Default: off.

--resume

Resume a previously started session.

--md5sum

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

--core 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.

EXAMPLES

To specify a CD device, type

ripit --device /dev/sr1

To specify the output directory, type

ripit --outputdir /foo/paths/

To rip'n'code 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,6

Note: in this case, RipIT assumes that Lame (encoder 0) is used in CBR mode wihtout quality option, so Oggenc (encoder 1) will get quality 3 and Flac (encoder 2) quality 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 either use --encopt, or directly 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" --qualoggenc ""

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 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

FILES

User config file:

$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)

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.