
#####
#
# RipIT 3.7.0 configuration file.
#
# For further information on ripit configuration / parameters
# and examples see the manpage or the README provided with ripit
# or type ripit --help .


#####
#
# Ripping device & path.
#

# cddevice: define ripping device
# if other than /dev/cdrom
# Default: /dev/cdrom

cddevice=/dev/cdrom

# output: path for audio files
# If not set, $HOME will be used.
# Default: not set

output=

# directory permissions: Permissions for directories
# Default: 0755

dpermission=0755

# file permissions: Permissions for sound and log files
# If not set, uses the default system settings.
# Default: not set

fpermission=


#####
#
# Ripping options.
#

# ripper: select CD ripper
# 0 - dagrab
# 1 - cdparanoia
# 2 - cdda2wav
# 3 - tosha
# 4 - cdd
# Default: cdparanoia

ripper=1

# ripopt: user definable options for the CD ripper
# Default: not set

ripopt=

# paranoia: turn "paranoia" on or off for dagrab
# and cdparanoia
# Possible values: 0 - no paranoia, 1 - use paranoia
#                  2 - switch paranoia off if ripping fails on one
#                      track and retry this track without paranoia
# Default: 1 - use paranoia

paranoia=1

# ghost: analyze the wavs for possible gaps,
# split the wav into chunks of sound and delete blank tracks.
# Possible values: 0 - off, 1 - on
# Default: off

ghost=0

# prepend: enlarge the the chunk of sound by a number of
# seconds at the beginning (if possible).
# Possible values: any positive number and zero; precision in
# tenths of seconds. Be aware of low numbers.
# Default: 2.0

prepend=2

# extend: enlarge the the chunk of sound by a number of
# seconds at the end (if possible).
# Possible values: any positive number and zero; precision in
# tenths of seconds. Be aware of low numbers.
# Default: 2.0

extend=2


#####
#
# Encoding options
#

# encode: encode the wavs
# Possible values: 0 - off, 1 - on
# Default: on

encode=1

# coder: Select encoders for audio files
# 0 - Lame (mp3)
# 1 - Oggenc (ogg)
# 2 - Flac (flac)
# 3 - Faac (m4a)
# Multiple encoders can be selected by giving
# a comma-separated list
# Example: coder=0,0,1,2 encodes CD twice to mp3, ogg and flac files
# Default: Lame

coder=0

###
#
# lame (mp3) encoder options
#

# qualame: Sets audio quality for lame encoder in
# cbr (lame-option -q) and vbr (lame-option -V) mode,
# comma seperated list.
# Possible values: 0...9, off
# 0: higest quality
# 9: lowest quality
# Can be set to "off" if all options are passed to
# --lameopt.
# Example: qualame=off,off
# Note: default value is the same for cbr and vbr,
# although vbr-default should be 4.
# Default: 5

qualame=5

# lameopt: Additional options for lame encoder,
# comma seperated list
# Example: lameopt=-b 128,--preset extreme
# Default: not set

lameopt=

# vbrmode: Enable varibale bitrate for lame encoder
# Possible values: "old" or "new"
# Default: not set

vbrmode=

# bitrate: Sets bitrate for lame encoder
# Possible values: 32...320, off
# Should be set to "off" if vbr is used
# Default: 128

bitrate=128

# maxrate: Sets maximum bitrate for lame (when using vbr)
# and oggenc
# Possible values: 0 - off, 32...320
# Default: 0

maxrate=0

# preset: Use lame presets
# To set the "fast" switch, use --vbrmode new.
# Possible values: medium, standard, extreme, insane
#
# medium: 160kbps
# standard: 192kbps
# extreme: 256kbps
# insane: 320kbps
#
# Default: not set

preset=

###
#
# oggenc (ogg) encoder options
#

# qualoggenc: Sets audio quality for oggenc
# Possible values: 1..10, off
# 1: lowest quality
# 10: highest quality
# Can be set to "off"
# Default: 3

qualoggenc=3

# oggencopt: Additional options for oggenc,
# comma seperated list
# Default: not set

oggencopt=

###
#
# flac (lossless) encoder options
#

# quaflac: Sets audio compression for flac encoder
# Possible values: 0...8, off
# 0: lowest compression
# 8: highest compression
# Can be set to "off"
# Default: 5

quaflac=5

# flacopt: Additional options for flac encoder,
# comma seperated list
# Default: not set

flacopt=

###
#
# faac (m4a) encoder options
#

# quafaac: Sets audio quality for faac encoder
# Possible values: 10...500, off
# 10: lowest quality
# 500: highest quality
# Can be set to "off"
# Default: 100

quafaac=100

# faacopt: Additional options for faac encoder,
# comma seperated list
# Default: not set

faacopt=


#####
#
# Trackname and directory template
#

# dirtemplate: Template for directory structure
# The template can be created using any legal
# character, including slashes (/) for multi-level
# directory-trees, and the following variables:
# $album
# $artist
# $iletter
# $genre
# $quality
# $suffix
# $trackname
# $tracknum
# $year
#
# The variable $iletter is the initial letter of
# the artist variable, the $quality is the quality
# according to the encoding format defined by $suffix.
# The variable $quality reflects the encoder options,
# not the arguments of option --quality which may be set
# to off.
#
# dirtemplate is an array, for each encoder a different
# dirtemplate may be defined (i. e. for each encoder state
# a line starting with dirtemplate=...).
#
# Example:
# dirtemplate="$suffix/hard_path/$iletter/$artist/$year - $album"
#
# The double quotes (") are mandatory!
# Default: "$artist - $album"

dirtemplate="$artist - $album"

# tracktemplate: Template for track names
# "tracktemplate" is used similarly to "dirtemplate"
# Default:  "$tracknum $trackname"

tracktemplate="$tracknum $trackname"

# infolog: Log certain operations to file
# (e.g. system calls, creation of dirs/files)
# Possible values: filename (full path, no ~ here!)
# Default: not set

infolog=

# lowercase: Convert filenames to lowercase
# Possible values: 0 - off, 1 - on
# Default: off

lowercase=0

# uppercasefirst: Convert filenames and tags to uppercase first,
# not recommended. To be used on the command line only if CDDB entry
# is in uppercase.
# Possible values: 0 - off, 1 - on
# Default: off

uppercasefirst=0

# underscore: Replace blanks in filenames with undersocres
# Possible values: 0 - off, 1 - on
# Default: off

underscore=0

# chars: Exclude special characters in file names and path.
# Note: following characters will always be purged:
#  ; > < " and \015 .
# Side note: if calling this option on the command line without
# argument, following characters will be purged:  |\:*?$  plus
# blanks and periods at beginning and end of file names and directories.
# This is identical to the word NTFS passed as argument to the command
# line or stated here in the config file. The word HFS will purge colons
# only plus blanks and periods at beginning of file names and
# directories.
#
# No need to escape the special characters here in the config file.
# Possible values: HFS, NTFS, none, any (?)
# Default: not set

chars=

# playlist: Create m3u playlist with or without the full path
# in the filename.
# Possible values: 0 - off,
                   1 - on with full path
#                  2 - on with no path (filename only)
# Default: on (with full path)

playlist=1


#####
#
# Audio file tagging
#

# year-tag: State a year (mp3, m4a) or a date (ogg, flac) tag.
# Possible values: integer
# Default: not set

year=

# comment-tag: State a comment (mp3, m4a) or a
# description (ogg, flac) tag.
# Possible values: any string
# Default: not set

comment=

# utftag: Use Lame-tags in UTF-8 or convert them
# (but not the filenames) from Unicode to ISO8859-1.
# Use when your mp3-audio player doesn't support Unicode tags.
# Recommended with Lame.
# Possible values: 0 - off, 1 - on
# Default: on

utftag=1


#####
#
# CDDB options
#

# CDDBHOST: Specifies the CDDB server
# Possible values: freedb.org, freedb2.org or musicbrainz.org
# Note: Full name of the server used is $mirror.$CDDBHOST, except for
# freedb2.org (no mirror) and musicbrainz.org has freedb as default
# mirror.
# E.g. default server is freedb.freedb.org
# Default: freedb.org

CDDBHOST=freedb.org

# mirror: Selects freedb mirror
# Possible values: "freedb" or any freedb mirrors
# See www.freedb.org for mirror list
# Note: Full name of the server used is $mirror.$CDDBHOST
# E.g., default server is freedb.freedb.org
# Default: freedb

mirror=freedb

# trasfer: Set transfer mode for cddb queries
# Possible values: cddb, http
# Note: CDDB servers freedb2.org and musicbrainz.org may need transfer
# mode http.
# Default: cddb

transfer=cddb

# proto: Set CDDP protocol level
# Possible values: 5, 6
# Protocol level 6 supports Unicode (UTF-8)
# Default: 6

proto=6

# proxy: Address of http-proxy, if needed
# Default: not set

proxy=

# mailad: Mail address for cddb submissions
# Valid user email address for submitting cddb entries
# Default: not set

mailad=

# archive: Read and save cddb data on local machine
# Possible values: 0 - off, 1 - on
# Default: off

archive=0

# submission: Submit new or edited cddb entries to
# freeCDDB
# Possible values: 0 - off, 1 - on
# Default: on

submission=1

# interaction: Turns on or off user interaction in cddb dialog
# Possible values: 0 - off, 1 - on
# Default: on

interaction=1


#####
#
# LCD options
#

# lcd: Use lcdproc to display status on LCD
# Possible values: 0 - off, 1 - on
# Default: off

lcd=0

# lcdhost: Specify the lcdproc host
# Default: localhost

lcdhost=localhost

# lcdport: Specify port number for localhost
# Default: 13666

lcdport=13666


#####
#
# Distributed ripping options
#

# sshlist: Comma separated list of remote machines
# that ripit shall use for encoding
# 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.
# Default: not set

sshlist=

# scp: Copy files to encode to the remote machine
# Use if the fs can not be accessed on the remote machines
# Possible values: 0 - off, 1 - on
# Default: off

scp=0

# local: Turn off encoding on local machine,
# e.g. use only remote machines
# Possible values: 0 - off, 1 - on
# Example: local=0 (off) turns off encoding on the
# local machine
# Default: on

local=1


#####
#
# Misc. options
#

# verbosity: Run silent (do not output comments, status etc.) (0), with
# minimal (1), normal without encoder msgs (2), normal (3), verbose (4)
# or extremly verbose (5)
# Possible values: 0...5
# Default: 3 - normal

verbose=3

# eject: Eject cd after finishing encoding
# Possible values: 0 - off, 1 - on
# Default: off

eject=0

# ejectcmd: Command used to eject and close CD tray
# Possible values: string
# Example: /usr/sbin/cdcontrol for FreeBSD
# Default: eject

ejectcmd=eject

# ejectopt: Options to command used to eject or close CD
# Possible values: string or "{cddev}" to design the CD
# device.
# Note: Don't use options -t / close or eject,
#       RipIT knows when to eject or load the tray
# Default: {cddev}

ejectopt={cddev}

# loop: Continue as soon a new CD is inserted,
# implies that the CD is ejected when done!
# Possible values: 0 - off, 1 - on
# Default: off

loop=0

# halt: Powers off machine after finishing encoding
# Possible values: 0 - off, 1 - on
# Default: off

halt=0

# nice: Sets "nice" value for the encoding process
# Possible values: 0..19 for normal users,
#                  -20..19 for user "root"
# Default: 0

nice=0

# nicerip: Sets "nice" value for the ripping process
# Possible values: 0..19 for normal users,
#                  -20..19 for user "root"
# Default: 0

nicerip=0

# threads: Comma separated list of numbers giving maximum
# of allowed encoder processes to run at the same time
# (on each machine when using sshlist).
# Possible values: comma separated integers
# Default: 1

threads=1

# md5sum: Create file with md5sums for each type of sound files
# Possible values: 0 - off, 1 - on
# Default: off

md5sum=0

# wav: Don't delete wave-files after encoding
# Possible values: 0 - off, 1 - on
# Default: off

wav=0

# normalize: Normalizes the wave-files to a given dB-value
# (Default: -12dB)
# See http://normalize.nongnu.org for details
# Possible values: 0 - off, 1 - on
# Default: off

normalize=0

# normcmd: Command to be used to normalize
# Possible values: string
# Example: normalize-audio (when using Debian)
# Default: normalize

normcmd=normalize

# 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.
# Default: -b
# The -v option will be added by default according to RipITs verbosity

normopt=-b

# cdtoc: Create a toc (cue) file to burn the wavs with
# cd-text using cdrdao or cdrecord (in dao mode)
# Possible values: 0 - off, 1 - on
# Default: off

cdtoc=0

