TRACKTOTAL written to ogg files
[abcde.git] / abcde.conf
index e0ba020..991bf0d 100644 (file)
@@ -1,4 +1,4 @@
-# System defaults for abcde version 2.2.x
+# System defaults for abcde version 2.6.1
 # Nothing in this file is uncommented by default.
 #
 # If you wish to override these system-wide settings, create your own
@@ -6,6 +6,7 @@
 
 # CDDB options
 # Choose whether you want to use CDDB or Musicbrainz. Default is CDDB
+# currently recognized options are 'cddb' and 'musicbrainz'
 #CDDBMETHOD=cddb
 
 # If you wish to use a different CDDB server, edit this line.
@@ -29,7 +30,7 @@
 # are cached locally in $CDDBLOCALDIR
 #CDDBCOPYLOCAL="n"
 #CDDBLOCALDIR="$HOME/.cddb"
-#CDDBLOCALRECURSIVE="n"
+#CDDBLOCALRECURSIVE="y"
 
 # If NOSUBMIT is set to y, then abcde will never prompt asking if you
 # wish to submit your edited cddb file.
@@ -44,7 +45,8 @@
 # Select here if you want to use the locally stored CDDB entries.
 # This is useful if you do a lot of editing to those CDDB entries.
 # Also, other tools like Grip store CDDB entries under $HOME/.cddb,
-# so they can be reused when ripping CDs.
+# so they can be reused when ripping CDs. (If this is set to "y" make
+# sure that CDDBLOCALRECURSIVE is also set to "y".)
 #CDDBUSELOCAL="n"
 
 # List, separated with a comma, the fields we want the parsing function to
 # flac - the only supported for FLACENCODERSYNTAX at the moment
 # speexenc - the only encoder for SPEEXENCODERSYNTAX
 # mpcenc - encoder for MPCENCODERSYNTAX
-# faac, neroAacEnc - for AACENCODER
-# opusenc - for OPUSENCODER
-# default is a valid option for oggenc, lame, flac, speexenc, mpcenc, faac and opus.
+# wavpack - encoder for WVENCODERSYNTAX
+# mac - for APENCODERSYNTAX
+# faac, neroAacEnc, fdkaac - for AACENCODERSYNTAX
+# opusenc - for OPUSENCODERSYNTAX
+# default is a valid option for oggenc, lame, flac, speexenc, mpcenc, wavpack, faac and opus.
 # Currently this affects the default location of the binary, the variable
 # to pick encoder command-line options from, and where the options are
 # given.
@@ -71,6 +75,8 @@
 #FLACENCODERSYNTAX=default
 #SPEEXENCODERSYNTAX=default
 #MPCENCODERSYNTAX=default
+#WVENCODERSYNTAX=default
+#APENCODERSYNTAX=default
 #AACENCODERSYNTAX=default
 #OPUSENCODERSYNTAX=default
 
@@ -79,7 +85,8 @@
 #NORMALIZERSYNTAX=default
 
 # CD reader program to use - currently recognized options are 'cdparanoia',
-# 'icedax', 'cdda2wav', 'dagrab', 'pird', 'cddafs' (Mac OS X only) and 'flac'.
+# 'libcdio' (cd-paranoia),'icedax', 'cdda2wav', 'dagrab', 'pird',
+# 'cddafs' (Mac OS X only) and 'flac'.
 #CDROMREADERSYNTAX=cdparanoia
 
 # CUE reader syntax for the CUE reader program to use.
 #DISTMP3NICE=10
 
 # Paths of programs to use
+
+# Encoders:
 #LAME=lame
 #TOOLAME=toolame
 #GOGO=gogo
 #FLAC=flac
 #SPEEXENC=speexenc
 #MPCENC=mpcenc
-#AACENC=faac
+#WVENC=wavpack
+#APENC=mac
+#FAAC=faac
+#NEROAACENC=neroAacEnc
+#FDKAAC=fdkaac
 #OPUSENC=opusenc
 
+# Taggers, rippers, replaygain etc:
 #ID3=id3
 #ID3V2=id3v2
 #EYED3=eyeD3
 #CDPARANOIA=cdparanoia
+#CD_PARANOIA=cd-paranoia
 #CDDA2WAV=icedax
 #PIRD=pird
 #CDDAFS=cp
 #MKCUE=mkcue
 #MKTOC=cdrdao
 #DIFF=diff
+#WVGAIN=wvgain
+#APETAG=apetag
+#GLYRC=glyrc
+#IDENTIFY=identify
+#CONVERT=convert
+#DISPLAYCMD=display
 
 # Options to call programs with:
 
 # MP3:
 # For the best LAME encoder options have a look at:
 # <http://wiki.hydrogenaudio.org/index.php?title=LAME#Recommended_encoder_settings>
-# The suggested '-V 0' below gives Variable Bitrate Rate (VBR) recording
+# A good option is '-V 0' which gives Variable Bitrate Rate (VBR) recording
 # with a target bitrate of ~245 Kbps and a bitrate range of 220...260 Kbps.
-#LAMEOPTS='-V 0'
+#LAMEOPTS=
 #TOOLAMEOPTS=
 #GOGOOPTS=
+# Bladeenc still works with abcde in 2015, and the last release of bladeenc
+# was in 2001! Settings that will produce a great encode are: '-br 192' 
 #BLADEENCOPTS=
+# L3enc still works with abcde in 2015, pretty amazing when you realise 
+# that the last release of l3enc was in 1997! Settings that will produce 
+# a great encode are: '-br 256000 -hq -crc'
 #L3ENCOPTS=
 #XINGMP3ENCOPTS=
+# And mp3enc also still works with abcde in 2015 with the last release
+# of mp3enc in 1998! Settings that will produce a great encode, albeit
+# a slow one, are: '-v -br 256000 -qual 9 -no-is -bw 16500'
 #MP3ENCOPTS=
 
 # Ogg:
 #SPEEXENCOPTS=
 
 # MPP/MP+ (Musepack):
-# For the encoder options look at: mpcenc --longhelp. Set them like this:
-# MPCENCOPTS='--xtreme' if you wish to set more options then:
-# MPCENCOPTS='--xtreme --skip 20 --fade 10'
+# For the encoder options look at 'mpcenc --longhelp', consider
+# setting '--extreme' for a good quality encode.
 #MPCENCOPTS=
 
+# WavPack:
+# Look at 'wavpack --help' for detailed options, consider using '-hx3' 
+# for a good quality encode
+#WVENCOPTS=
+# For Wavpack replay gain we set both the default of 'track gain' 
+# as well as this option for 'album gain'. Better media players
+# such as vlc can select either or neither.    
+#WVGAINOPTS='-a'
+
+# Monkey's Audio (ape)
+# Without this set mac chokes unfortunately. Choices
+# are from 1000 to 5000.
+#APENCOPTS='-c4000'
+
 # M4A/AAC
-#For faac encoding try the following options (see also: faac --help):
-#AACENC=faac
-#AACENCOPTS='-q 250 -w -s'
-#OUTPUTTYPE="m4a"
-# For neroAacEnc encoding try the following options (see also neroAacEnc -help):
-#AACENC=neroAacEnc
-#AACENCOPTS='-q 0.65'
-#OUTPUTTYPE="m4a"
-#ATOMICPARSLEY='AtomicParsley'
+# Note that the old AACENCOPTS has been rendered obsolete by
+# the following options, new to abcde 2.6.1:
+#  1. faac: see 'faac --long-help' and consider
+#     using '-q 250' for a good quality encode.
+#FAACENCOPTS=
+#  2. neroAacEnc: see 'neroAacEnc -help' and
+#     consider using '-q 0.65' for a good quality encode.
+#NEROAACENCOPTS=
+#  3. fdkaac: see 'fdkaac --help' and consider using 
+#     '--profile 2 --bitrate-mode 5 --afterburner 1'
+#     for a good quality encode. 
+#FDKAACENCOPTS='--bitrate 192k'
 
 # OPUS
-# For the encoder options look at: opusenc -h.
-#OPUSENCOPTS='--bitrate 128'
-
-# There are three ways to tag MP3 files: id3v1 (with id3), id3v2.3
-# (with id3v2) and id3v2.4 (with eyeD3). Use ID3TAGV to select one of
-# the older formats
+# For the encoder options look at: 'opusenc -h'
+#OPUSENCOPTS=
+
+# mp3 tagging:
+# There are three ways to tag MP3 files:
+#   1. id3v1 (with id3)
+#   2. id3v2.3 (with id3v2)
+#   3. id3v2.4 (with eyeD3) This is the default
+# Use ID3TAGV to select one of the older formats:
 #ID3TAGV=id3v2.4
 #ID3OPTS=
 #ID3V2OPTS=
 #EYED3OPTS="--set-encoding=utf16-LE"
+
+# Other options:
+# The variable CDPARANOIOPTS is also used by GNU's cd-paranoia,
+# so use this when setting CDROMREADERSYNTX=libcdio.
 #CDPARANOIAOPTS=
 #CDDA2WAVOPTS=
 #PIRDOPTS="-p"
 #DIFFOPTS=""
 #VORBISCOMMENTOPTS="-R"
 #METAFLACOPTS="--no-utf8-convert"
-#DIFFOPTS=""
 
 # Actions to take
 # Comma-separated list of one or more of the following:
-#  cddb,cue,read,normalize,encode,tag,move,playlist,clean,default
+#  cddb,cue,read,normalize,encode,tag,move,replaygain,playlist,getalbumart,clean,default
 #   encode implies read
 #   normalize implies read
 #   tag implies cddb,read,encode
 #   move implies cddb,read,encode,tag
+#   replaygain implies cddb,read,encode,tag,move
 #   playlist implies cddb
 # An action can be added to the "default" action by specifying it along with
 # "default", without having to repeat the default ones:
 # OUTPUTTYPE can be any of a number of formats, either a single format
 # (e.g. "ogg") or a combination of them separated with ","
 # (e.g. "flac,mp3"). Currently recognised and supported are:
-# "flac", "m4a", "mp3, "mpc", "ogg", "opus", "spx", "vorbis", "wav"
+# "flac", "m4a", "mp3, "mpc", "ogg", "opus", "spx", "vorbis", "wav", "wv", "ape"
 #OUTPUTTYPE=ogg
 
 # Output filename format - change this to reflect your inner desire to
 #(some hardware players insist on CR-LF line-endings)
 #DOSPLAYLIST=n
 
+# album art download options (see glyrc's help for details with more detailed 
+# examples here: https://github.com/sahib/glyr/wiki/Commandline-arguments).
+# For example use '--formats jpg;jpeg' to only search for JPEG images
+# These options: '--from <provider>' and '--lang <langcode>' might also be useful
+#GLYRCOPTS=
+#ALBUMARTFILE="cover.jpg"
+#ALBUMARTTYPE="JPEG"
+
+# Options for ImageMagick commands used by album art processing when available
+# For example: CONVERTOPTS="-colorspace RGB -resize 600x600>"
+# to make the image RGB and fit inside 600x600 while keeping the aspect ratio
+#IDENTIFYOPTS=
+#CONVERTOPTS=
+#DISPLAYCMDOPTS="-resize 512x512 -title abcde_album_art"
+# By default convert is only called when the image type is different from
+# ALBUMARTTYPE, use ALBUMARTALWAYSCONVERT="y" to always call convert
+#ALBUMARTALWAYSCONVERT="n"
+
 # Custom filename munging:
 # By default, abcde will do the following to CDDB data to get a useful
 # filename: