TRACKTOTAL written to ogg files
[abcde.git] / abcde.conf
index 1e47d46..991bf0d 100644 (file)
@@ -1,4 +1,4 @@
-# System defaults for abcde version 2.6.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.
@@ -84,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.
 #MPCENC=mpcenc
 #WVENC=wavpack
 #APENC=mac
-#AACENC=faac
+#FAAC=faac
+#NEROAACENC=neroAacEnc
+#FDKAAC=fdkaac
 #OPUSENC=opusenc
 
 # Taggers, rippers, replaygain etc:
 #ID3V2=id3v2
 #EYED3=eyeD3
 #CDPARANOIA=cdparanoia
+#CD_PARANOIA=cd-paranoia
 #CDDA2WAV=icedax
 #PIRD=pird
 #CDDAFS=cp
 #DIFF=diff
 #WVGAIN=wvgain
 #APETAG=apetag
+#GLYRC=glyrc
+#IDENTIFY=identify
+#CONVERT=convert
+#DISPLAYCMD=display
 
 # Options to call programs with:
 
 #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'                       Andrew.
+# 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'.      Andrew.
+# a slow one, are: '-v -br 256000 -qual 9 -no-is -bw 16500'
 #MP3ENCOPTS=
 
 # Ogg:
 #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.              Andrew.     
+# such as vlc can select either or neither.    
 #WVGAINOPTS='-a'
 
 # Monkey's Audio (ape)
 #APENCOPTS='-c4000'
 
 # M4A/AAC
+# 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. 
-#AACENCOPTS=
+#FDKAACENCOPTS='--bitrate 192k'
 
 # OPUS
 # For the encoder options look at: 'opusenc -h'
 #OPUSENCOPTS=
 
 # mp3 tagging:
-# 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
+# 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,replaygain,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
 #(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: