Fix (again!) dealing with CDs with no release events
[abcde.git] / abcde.conf
index 6a60e0b..5c8e740 100644 (file)
@@ -5,10 +5,11 @@
 # .abcde.conf file in your home directory.
 
 # CDDB options
-# Choose whether you want to use "cddb" and/or "musicbrainz". Default
-# is "musicbrainz", but both can be specified in a comma delimited list
-# to be tried sequentially in the event of failure of the first
-# search.
+
+# Choose whether you want to use "cddb", "musicbrainz" and/or
+# "cdtext". Default is "musicbrainz", but all can be specified in a
+# comma delimited list to be tried sequentially. All the results will
+# be displayed ready for user choice.
 #CDDBMETHOD=musicbrainz
 
 # If you wish to use a different CDDB server, edit this line.
@@ -70,6 +71,7 @@
 # opusenc - for OPUSENCODERSYNTAX
 # twolame, ffmpeg - for MP2ENCODERSYNTAX
 # tta, ttaenc - for TTAENCODERSYNTAX
+# ffmpeg - for AIFFENCODERSYNTAX
 # default is a valid option for oggenc, lame, flac, speexenc, mpcenc, wavpack,
 # fdkaac, opus, twolame and tta. Currently this affects the default location of the
 # binary, the variable to pick encoder command-line options from, and where
@@ -86,6 +88,7 @@
 #OPUSENCODERSYNTAX=default
 #MP2ENCODERSYNTAX=default
 #TTAENCODERSYNTAX=default
+#AIFFENCODERSYNTAX=default
 
 # Specify the syntax of the normalize binary here - so far only 'normalize'
 # is supported.
 #MKTOC=cdrdao
 #DIFF=diff
 #WVGAIN=wvgain
+#WVTAG=wvtag
 #APETAG=apetag
 #GLYRC=glyrc
 #IDENTIFY=identify
 # are from 1000 to 5000.
 #APENCOPTS='-c4000'
 
+#AIFF
+# These options needed by FFmpeg for tagging and selection of id3v2 version:
+#  1. '-write_id3v2 1' allows id3v2 tagging while '-write_id3v2 0' disables tagging
+#  2. '-id3v2_version 4' gives version id3v2.4 while '3' gives id3v2.3 
+#AIFFENCOPTS="-write_id3v2 1 -id3v2_version 4"
+
 # M4A/AAC
 # There are now 6 AAC encoders available to abcde, the default being
 # fdkaacenc. Note that the old AACENCOPTS has been rendered obsolete by
 
 # Actions to take
 # Comma-separated list of one or more of the following:
-#  cddb,cue,read,normalize,encode,tag,move,replaygain,playlist,getalbumart,clean,default
+#  cddb,cue,read,normalize,encode,tag,move,replaygain,playlist,getalbumart,embedalbumart,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
+#   embedalbumart implies getalbumart
 # An action can be added to the "default" action by specifying it along with
 # "default", without having to repeat the default ones:
 #  ACTIONS=default,playlist
 # 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", "mka", "spx", "vorbis", "wav", "wv", "ape"
+# "flac", "m4a", "mp3, "mpc", "ogg", "opus", "mka", "spx", "vorbis", "wav", "wv", "ape", "aiff"
 #OUTPUTTYPE=ogg
 
 # Output filename format - change this to reflect your inner desire to
 #      echo "$@" | sed -e 's/^\.*//' -e 's/ /_/g' | tr -d ":><|*/\"'?[:cntrl:]"
 #}
 #
+# More examples for custom filename munging:
+#
+# VARIANT 1: (works anywhere style)
+#
+# Translate everything to lowercase
+# replace ALL chars that may cause trouble for Linux, Windows and DOS
+# with '_' (underscore); remove double underscores; remove leading and
+# trailing underscores; recode to flat ASCII
+#
+#mungefilename ()
+#{
+#      echo "$@" | tr [A-Z] [a-z] | \
+#                      sed "s/[- ,.:\'\/!@#\?\$%\^&()]/_/g" | \
+#                      sed 's/_[_]*/_/g' | \
+#                      sed 's/^_*//' | \
+#                      sed 's/_*$//' | \
+#                      recode -f iso8859-1..flat
+#}
+#
+# VARIANT 2: (legible style)
+#
+# Accept all chars, EXCEPT '/' (obvious) or ":" (because eyeD3 cannot
+# cope with ":" in pathnames): replace them with " " (space).
+# Additionally, replace contiguous spaces with one space; strip
+# leading spaces; strip trailing spaces and recode to flat filenames.
+#
+# mungefilename ()
+# {
+#      echo "$@" |     sed "s/[:\/]/ /g" | \
+#                      sed 's/ [ ]*/ /g' | \
+#                      sed 's/^ *//' | \
+#                      sed 's/ *$//' | \
+#                      recode -f iso8859-1..flat
+# }
+
+
+#
 # Custom filename munging specific to track names:
 # By default this function will call the mungefilename function.
 #mungetrackname ()