4 # Ripping device & path.
7 # cddevice: Define ripping device if other than /dev/cdrom.
12 # output: Path for audio files. If not set, $HOME will be used.
15 output=/home/don/media/audio
17 # directory permissions: Permissions for directories.
22 # file permissions: Permissions for sound and log files.
23 # If not set, uses the default system settings.
34 # ripper: select CD ripper
44 # ripopt: User definable options for the CD ripper.
49 # span: Rip only part of a single track or the merged track-interval.
50 # Possible values: any in the format hh:mm:ss.ff-hh:mm:ss.ff
51 # Example: rip first 30s of each track: 0-30
56 # paranoia: Turn "paranoia" on or off for dagrab and cdparanoia.
57 # Possible values: 0 - no paranoia, 1 - use paranoia
58 # 2 - switch paranoia off if ripping fails on one
59 # track and retry this track without paranoia
60 # Default: 1 - use paranoia
64 # ghost: Analyze the wavs for possible gaps, split the wav into
65 # chunks of sound and delete blank tracks.
66 # Possible values: 0 - off, 1 - on
71 # prepend: Enlarge the the chunk of sound by a number of
72 # seconds at the beginning (if possible).
73 # Possible values: any positive number and zero; precision in
74 # tenths of seconds. Be aware of low numbers, especially when
80 # extend: Enlarge the the chunk of sound by a number of
81 # seconds at the end (if possible).
82 # Possible values: any positive number and zero; precision in
83 # tenths of seconds. Be aware of low numbers.
88 # resume: Resume a previously started session.
89 # Possible values: 0 - off, 1 - on
94 # overwrite: Default behaviour of Ripit is not to overwrite existing
95 # directories, a suffix will be added if directory name exists.
96 # Use option overwrite to prevent this and either overwrite a previous
97 # rip or force Ripit to quit or even eject the disc. If ejection is
98 # chosen, the disc will be ejected even if option eject has not been
100 # Possible values: n - off, y - on,
101 # q - quit, e - quit and force ejection
112 # encode: Encode the wavs.
113 # Possible values: 0 - off, 1 - on
118 # coder: Select encoders for audio files:
123 # 4 - mp4als (als or mp4)
127 # Multiple encoders can be selected by giving a comma separated list
128 # Example: coder=0,0,1,2 encodes CD twice to mp3, ogg and flac files
139 # lame (mp3) encoder options
142 # qualame: Sets audio quality for lame encoder in cbr (lame-option -q)
143 # and vbr (lame-option -V) mode, comma separated list if encoder is
144 # used several times.
145 # Possible values: 0...9, off
148 # Can be set to "off" if all options are passed to --lameopt.
149 # Example: qualame=off,off
150 # Note: default value is the same for cbr and vbr,
151 # although vbr-default should be 4.
156 # lameopt: Additional options for lame encoder,
157 # use a comma separated list if encoder is used several times.
158 # Example: lameopt=-b 128,--preset extreme
163 # vbrmode: Enable variable bitrate for lame encoder.
164 # Possible values: "old" or "new"
169 # bitrate: Sets bitrate for lame encoder.
170 # Possible values: 32...320, off
171 # Should be set to "off" if vbr is used
176 # maxrate: Sets maximum bitrate for lame (when using vbr) and oggenc.
177 # Possible values: 0 - off, 32...320
182 # preset: Use lame presets. To set the "fast" switch, use --vbrmode new.
183 # Possible values: medium, standard, extreme, insane
196 # oggenc (ogg) encoder options
199 # qualoggenc: Sets audio quality for oggenc.
200 # Possible values: 1..10, off
202 # 10: highest quality
203 # Can be set to "off"
208 # oggencopt: Additional options for oggenc,
209 # use a comma separated list if encoder is used several times.
216 # flac (lossless) encoder options
219 # quaflac: Sets audio compression for flac encoder
220 # Possible values: 0...8, off
221 # 0: lowest compression
222 # 8: highest compression
223 # Can be set to "off"
228 # flacopt: Additional options for flac encoder,
229 # use a comma separated list if encoder is used several times.
230 # Example of single encoder:
231 # flacopt=--padding=8212 --replay-gain
232 # Example of multiple encoder:
233 # flacopt=--padding=8212 --replay-gain,--padding=8212
234 # Note: If using the --replay-gain option the padding option
235 # is recommended, otherwise all padding might be lost.
242 # faac (m4a) encoder options
245 # quafaac: Sets audio quality for faac encoder
246 # Possible values: 10...500, off
248 # 500: highest quality
249 # Can be set to "off"
254 # faacopt: Additional options for faac encoder,
255 # comma separated list if encoder is used several times.
262 # mp4als (als or mp4) encoder options
265 # quamp4als: Set audio compression level for mp4als.
266 # Note: Options that influence compression and speed
267 # should be used in the mp4als options below.
272 # mp4alsopt: Additional options for mp4als encoder,
273 # comma separated list if encoder is used several times.
274 # Example: -MP4 to allow tagging, mandatory.
275 # Example: -a -o30 for faster speed.
282 # Musepack (mpc) encoder options
285 # musenc: The encoder name on the command line
286 # Possible values: any
287 # Example: musenc=mppenc for older versions
292 # quamuse: Sets audio quality for Musepack encoder
293 # Possible values: 0...10, off
295 # 10: highest quality
296 # Can be set to "off"
301 # museopt: Additional options for Musepack encoder,
302 # use a comma separated list if encoder is used several times.
309 # Wavpack (wv) encoder options
312 # wavpacopt: Additional options for Wavpack encoder,
313 # use a comma separated list if encoder is used several times.
321 #ffmpeg encoder options
324 # ffmpegopt: Additional options for ffmpeg,
325 # use a comma separated list if encoder is used several times.
326 # Example if ffmpeg is used twice: -acodec alac,-acodec wmav2
331 # ffmpegsuffix: Suffix to be used for ffmpeg,
332 # use a comma separated list if encoder is used several times.
333 # Example if ffmpeg is used twice: m4a,wma
341 # Trackname and directory template
344 # dirtemplate: Template for directory structure
345 # The template can be created using any legal
346 # character, including slashes (/) for multi-level
347 # directory-trees, and the following variables:
359 # The variable $iletter is the initial letter of
360 # the artist variable, the $quality is the quality
361 # according to the encoding format defined by $suffix.
362 # The variable $quality reflects the encoder options,
363 # not the arguments of option --quality which may be set
364 # to off. The variable $trackno is the total number of tracks
367 # dirtemplate is an array, for each encoder a different
368 # dirtemplate may be defined (i. e. for each encoder state
369 # a line starting with dirtemplate=...).
372 # dirtemplate="$suffix/hard_path/$iletter/$artist/$year - $album"
374 # The double quotes (") are mandatory!
375 # Default: "$artist - $album"
377 dirtemplate="${artist}/${album}"
379 # tracktemplate: Template for track names
380 # "tracktemplate" is used similarly to "dirtemplate"
381 # Default: "$tracknum $trackname"
383 tracktemplate="${tracknum}_${trackname}"
385 # trackoffset: Add an offset to the track counter ($tracknum)
386 # Possible values: any integer
391 # infolog: Log certain operations to file
392 # (e.g. system calls, creation of dirs/files)
393 # Possible values: filename (full path, no ~ here!)
398 # lowercase: Convert filenames to lowercase
399 # Possible values: 0 - off, 1 - on
404 # uppercasefirst: Convert filenames and tags to uppercase first,
405 # not recommended. To be used on the command line only if CDDB entry
407 # Possible values: 0 - off, 1 - on
412 # underscore: Replace blanks in filenames with underscores
413 # Possible values: 0 - off, 1 - on
418 # chars: Exclude special characters in file names and path.
419 # Note: following characters will always be purged:
421 # Side note: if calling this option on the command line without
422 # argument, following characters will be purged: |\:*?$ plus
423 # blanks and periods at beginning and end of file names and directories.
424 # This is identical to the word NTFS passed as argument to the command
425 # line or stated here in the config file. The word HFS will purge colons
426 # only plus blanks and periods at beginning of file names and
429 # No need to escape the special characters here in the config file.
430 # Possible values: HFS, NTFS, none, any (?)
435 # playlist: Create m3u playlist with or without the full path
437 # Possible values: 0 - off,
438 # 1 - on with full path
439 # 2 - on with no path (filename only)
440 # Default: on (with full path)
450 # year-tag: State a year (mp3, m4a) or a date (ogg, flac) tag.
451 # Possible values: integer
456 # comment-tag: State a comment (mp3, m4a, mpc) or a
457 # description (ogg, flac) tag. To write the cddbid used for freedb
458 # or the MusicBrainz discid into the comment, use the word "cddbid"
460 # Possible values: discid, cddbid or any string
465 # mp3tags: Additional tags for mp3 not passed by the encoder.
466 # Example: Force a unofficial compilation frame when using within
467 # a certain player: TCMP=1
468 # Note: option is an array, for each additional frame/tag to be added
469 # state the option once.
470 # Possible values: none, any
475 # utftag: Use Lame-tags in UTF-8 or convert them
476 # (but not the filenames) from Unicode to ISO8859-1.
477 # Use when your mp3-audio player doesn't support Unicode tags.
478 # Recommended with Lame.
479 # Possible values: 0 - off, 1 - on
484 # coverart: Add cover image to metadata of encoded file if possible.
485 # Note: The cover must be available when encoding starts, one might
486 # want to use option --precmd to execute a script for downloading and
487 # preparing a cover. Argument is a list in same order as encoders with
488 # values 0 (no coverart) or 1 (add coverart) for each encoder.
490 # Possible values: 0 - off, 1 - on
495 # coverpath: Path where the cover can be found.
496 # Example: ../thumb.png
497 # Possible values: string, none
502 # copycover: Copy a cover (or any other file) to all
503 # directories containing encoded files. Useful e.g. when using Amarok.
504 # Example: "$wavdir/cover.jpg"
505 # Possible values: none - off, absolute path to image
510 # vatag: Analyze tracknames for "various artists" style and split
511 # the metadata in case one of the delimiters (colon, hyphen, slash or
512 # parenthesis) are found. Use unpair numbers for the scheme
513 # "artist ? tracktitle" and pair numbers in the opposite case.
514 # The artist will be compared to the argument of option --vastring
515 # (see below). If the artist must be like vastring and each track have a
516 # delimiter, use 1 (2), if the artist must be like vastring while only
517 # some tracks contain the delimiter, use 3 (4), if no restrictions
518 # apply for the artist but all tracknames must have a delimiter, use
519 # 5 (6) and finally, if only a few tracks contain a delimiter to be
520 # used as splitting point, set vatag to 7 (8).
522 # Possible values: 0 - off, 1, 2, 3, 4, 5, 6, 7, 8
527 # vastring: the string (regular expression) that defines the
528 # "various artists" style
530 # Possible values: string, none
531 # Default: \bVA\b|Variou*s|Various\sArtists
533 vastring=\bVA\b|Variou*s|Various Artists
535 # mp3gain: Add album gain tags to mp3 files using the appropriate
536 # command with options and arguments but without infiles.
537 # Example: mp3gain -a -c -q -s i
542 # vorbgain: Add album gain tags to ogg files using the appropriate
543 # command with options and arguments but without infiles.
544 # Example: vorbisgain -a -q
549 # flacgain: Add album gain tags to flac files using the appropriate
550 # command with options and arguments but without infiles.
551 # Example: metaflac --add-replay-gain
556 # aacgain: Add album gain tags to mp4 or m4a files using the appropriate
557 # command with options and arguments but without infiles.
558 # Example: aacgain -a -c -q
563 # mpcgain: Add album gain tags to mpc files using the appropriate
564 # command with options and arguments but without infiles.
570 # wvgain: Add album gain tags to wv files using the appropriate
571 # command with options and arguments but without infiles.
572 # Example: wvgain -a -q
583 # mb: Access MusicBrainz DB via WebService::MusicBrainz module instead
584 # of the http protocol (see below).
585 # Possible values: 0 - off, 1 - on
590 # CDDBHOST: Specifies the CDDB server
591 # Possible values: freedb.org, freedb2.org or musicbrainz.org
592 # Note: Full name of the server used is $mirror.$CDDBHOST, except for
593 # freedb2.org (no mirror) and musicbrainz.org has freedb as default
595 # E.g. default server is freedb.freedb.org
596 # Default: freedb.org
600 # mirror: Selects freedb mirror
601 # Possible values: "freedb" or any freedb mirrors
602 # See www.freedb.org for mirror list
603 # Note: Full name of the server used is $mirror.$CDDBHOST
604 # E.g., default server is freedb.freedb.org
609 # transfer: Set transfer mode for cddb queries
610 # Possible values: cddb, http
611 # Note: CDDB servers freedb2.org and musicbrainz.org may need transfer
617 # proto: Set CDDP protocol level
618 # Possible values: 5, 6
619 # Protocol level 6 supports Unicode (UTF-8)
624 # proxy: Address of http-proxy, if needed.
629 # mailad: Mail address for cddb submissions.
630 # Possible values: Valid user email address for submitting cddb entries
635 # archive: Read and save cddb data on local machine.
636 # Possible values: 0 - off, 1 - on
641 # submission: Submit new or edited cddb entries to freeCDDB.
642 # Possible values: 0 - off, 1 - on
647 # interaction: Turns on or off user interaction in cddb dialog and
649 # Possible values: 0 - off, 1 - on
654 # isrc: detect track iscrs using icedax and submit them to Musicbrainz
655 # if login info is provided. Please check if the device in use is
656 # able to read correct ISRCs and submit them if found.
657 # Possible values: 0 - off, 1 - on
662 # mbname: login name to Musicbrainz.org
663 # Possible values: string
668 # mbpass: password to Musicbrainz.org
669 # Possible values: string
680 # lcd: Use lcdproc to display status on LCD
681 # Possible values: 0 - off, 1 - on
686 # lcdhost: Specify the lcdproc host
691 # lcdport: Specify port number for localhost
699 # Distributed ripping options
702 # sshlist: Comma separated list of remote machines ripit shall use
703 # for encoding. The output path must be the same for all machines.
704 # Specify the login (login@machine) only if not the
705 # same for the remote machine. Else just state the
711 # scp: Copy files to encode to the remote machine.
712 # Use if the fs can not be accessed on the remote machines
713 # Possible values: 0 - off, 1 - on
718 # local: Turn off encoding on local machine, e.g. use only remote
720 # Possible values: 0 - off, 1 - on
721 # Example: local=0 (off) turns off encoding on the
733 # verbosity: Run silent (do not output comments, status etc.) (0), with
734 # minimal (1), normal without encoder msgs (2), normal (3), verbose (4)
735 # or extremely verbose (5).
736 # Possible values: 0...5
737 # Default: 3 - normal
741 # eject: Eject cd after finishing encoding.
742 # Possible values: 0 - off, 1 - on
747 # ejectcmd: Command used to eject and close CD tray.
748 # Possible values: string
749 # Example: /usr/sbin/cdcontrol for FreeBSD
754 # ejectopt: Options to command used to eject or close CD.
755 # Possible values: string or "{cddev}" to design the CD
757 # Note: Don't use options -t / close or eject,
758 # RipIT knows when to eject or load the tray
763 # quitnodb: Give up CD if no CDDB entry found.
764 # Useful if option --loop or --nointeraction are on.
765 # Default behaviour is to let operator enter data or to use default
766 # artist, album and track names.
767 # Possible values: 0 - off, 1 - on
772 # execmd: Execute a command when done with ripping. Quote the command
774 # Note: The same variables as in the dirtemplate can be used. When
775 # using MusicBrainz one might want to use $cd{asin} to get the ASIN
777 # Possible values: none - off, string - on
778 # Example: execmd="add_db -a \"$artist\" -r \"$album\""
783 # precmd: Execute a command before starting to rip. Quote the command
785 # Note: The same variables as in the dirtemplate can be used. When
786 # using MusicBrainz one might want to use $cd{asin} to get the ASIN
788 # Possible values: none - off, string - on
789 # Example: precmd="get_cover -a \"$artist\" -r \"$album\" -o \"$wavdir\" -t \"$trackno\""
792 precmd="/home/don/bin/get_coverart --asin \"$cd{asin}\" --artist \"$artist\" --album \"$album\" --cover \"/home/don/media/audio/${artist}/${album}/AlbumArt.jpg\""
794 # book: Create an audiobook, i. e. merge all tracks into one single
795 # file, option --ghost will be switched off and file suffix will be
796 # m4b. Make sure to use encoder faac, ripit will not check that.
797 # A chapter file will be written for chapter marks.
798 # Possible values: 0 - off, 1 - on
803 # loop: Continue with a new CD when the previous one is done.
804 # Option --eject will be forced. To start ripping process immediately
805 # after ejection of previous disc, use experimental argument 2. Ripit
806 # will restart as child process, one might see the prompt and it will
807 # be necessary to manually terminate the process! Use with caution!
808 # Possible values: 0 - off, 1 - on, 2 - immediate restart, experimental
813 # halt: Powers off machine after finishing encoding.
814 # Possible values: 0 - off, 1 - on
819 # nice: Sets "nice" value for the encoding process.
820 # Possible values: 0..19 for normal users,
821 # -20..19 for user "root"
826 # nicerip: Sets "nice" value for the ripping process.
827 # Possible values: 0..19 for normal users,
828 # -20..19 for user "root"
833 # threads: Comma separated list of numbers giving maximum
834 # of allowed encoder processes to run at the same time
835 # (on each machine when using sshlist).
836 # Possible values: comma separated integers
841 # md5sum: Create file with md5sums for each type of sound files.
842 # Possible values: 0 - off, 1 - on
847 # wav: Don't delete wave-files after encoding.
848 # Possible values: 0 - off, 1 - on
853 # normalize: Normalizes the wave-files to a given dB-value
855 # See http://normalize.nongnu.org for details.
856 # Possible values: 0 - off, 1 - on
861 # normcmd: Command to be used to normalize.
862 # Possible values: string
863 # Example: normalize-audio (when using Debian)
864 # Upstream default: normalize
866 # We are running Debian so set to normalize-audio
867 normcmd=normalize-audio
869 # normopt: Options to pass to normalize
870 # Possible values: -a -nndB : Normalize to -nn dB, default is -12dB,
871 # Value range: All values <= 0dB
872 # Example : normalize -a -20dB *.wav
873 # -b : Batch mode - loudness differences
874 # between individual tracks of a CD are
876 # -m : Mix mode - all track are normalized to
878 # -v : Verbose operation
879 # -q : Quiet operation
880 # For further options see normalize documentation.
882 # The -v option will be added by default according to RipITs verbosity
886 # cdtoc: Create a toc file to burn the wavs with
887 # cd-text using cdrdao or cdrecord (in dao mode).
888 # Possible values: 0 - off, 1 - on
893 # inf: Create inf files to burn the wavs with
894 # cd-text using wodim or cdrecord (in dao mode).
895 # Possible values: 0 - off, 1 - on
900 # cdcue: Create a cue file to burn the wavs with cd-text.
901 # Possible values: 0 - off, 1 - on, 2 - on (experimental fallback)
902 # Note: Use value 2 only if for whatever reason value 1 should fail.