.TH abcde 1
.SH NAME
abcde \- Grab an entire CD and compress it to Ogg/Vorbis, MP3, FLAC, Ogg/Speex, AAC,
-WavPack, Monkey's Audio (ape), MPP/MP+(Musepack), True Audio (tta) and/or MP2 format.
+WavPack, Monkey's Audio (ape), MPP/MP+(Musepack), True Audio (tta), MP2 format
+and/or AIFF (Audio Interchange File Format).
.SH SYNOPSIS
.B abcde
.I [options] [tracks]
is designed to automate this. It will take an entire CD and convert it into
a compressed audio format - Ogg/Vorbis, MPEG Audio Layer III (MP3), Free Lossless
Audio Codec (FLAC), Ogg/Speex, MPP/MP+(Musepack), M4A (AAC) wv (WavPack),
-Monkey's Audio (ape), Opus, True Audio (tta) or MPEG Audio Layer II (MP2) format(s).
+Monkey's Audio (ape), Opus, True Audio (tta), MPEG Audio Layer II (MP2)
+or AIFF (Audio Interchange File Format) format(s).
With one command, it will:
.TP
.B *
.TP
.B *
Compress to Ogg/Vorbis, MP3, FLAC, Ogg/Speex, MPP/MP+(Musepack), M4A, wv (WavPack),
-Monkey's Audio (ape), Opus format(s) True Audio (tta) and/or MP2, all in one CD read
+Monkey's Audio (ape), Opus format(s), True Audio (tta), MP2 or AIFF
+(Audio Interchange File Format) all in one CD read
.TP
.B *
Comment or ID3/ID3v2 tag
.B \-B
Enable automatic embedding of album art with certain containers. As of
abcde 2.8.2 supported containers are mp3 (using eyeD3), flac (using
-metaflac) and m4a (using AtomicParsley). This command line option also
-calls the getalbumart function. Further details of album art embedding
-using the embedalbumart function can be found in the abcde FAQ document
-packaged with abcde.
+metaflac), m4a (using AtomicParsley), WavPack aka wv (using wvtag) and
+experimental support for ogg (using vorbiscomment). This command line
+option also calls the getalbumart function. Further details of album art
+embedding using the embedalbumart function can be found in the abcde FAQ
+document packaged with abcde.
.TP
.B \-c [filename]
Specifies an additional configuration file to parse. Configuration options
.TP
.B \-o [filetype][:filetypeoptions]
Select output type. Can be "vorbis" (or "ogg"), "mp3", "flac", "spx", "mpc", "m4a",
-"wav", "wv", "ape", "opus" or "mka". Specify a comma-delimited list of output types
+"wav", "wv", "ape", "opus", "mka" or "aiff". Specify a comma-delimited list of output types
to obtain all specified types. See the OUTPUTTYPE configuration variable. One can
pass options to the encoder for a specific filetype on the command line separating
them with a colon. The options must be escaped with double-quotes.
modified using the OUTPUTFORMAT and VAOUTPUTFORMAT variables in your
\fIabcde.conf\fR. Each file is given an extension identifying its compression
format, 'vorbis' for '.ogg', '.mp3', '.flac', '.spx', '.mpc', '.wav', '.wv',
-\(aq.ape', '.opus' or '.mka'.
+\(aq.ape', '.opus', '.mka' or 'aiff'.
.SH CONFIGURATION
\fBabcde\fR sources two configuration files on startup - \fI/etc/abcde.conf\fR and
\fI$HOME/.abcde.conf\fR, in that order.
for mka include Vorbis, MP2, MP3, LC-AAC, HE-AAC, WMAv1, WMAv2, AC3, eAC3 and Opus.
See the FAQ document for more information.
.TP
+.B AIFFENCODERSYNTAX
+Specifies the style of encoder to use for Audio Interchange File Format (AIFF).
+At this point only \'ffmpeg\' is available to utilise the AIFF container.
+.TP
.B NORMALIZERSYNTAX
Specifies the style of normalizer to use. Valid options are \'default\'
and \'normalize'\ (and both run \'normalize-audio\'), since we only support it,
.TP
.B COMMAND-LINE OPTIONS
If you wish to specify command-line options to any of the programs \fBabcde\fR uses,
-set the following configuration file options: LAMEOPTS, GOGOOPTS,
+set the following configuration file options: LAMEOPTS, GOGOOPTS, AIFFENCOPTS,
BLADEENCOPTS, L3ENCOPTS, XINGMP3ENCOPTS, MP3ENCOPTS, VORBIZEOPTS, WAVEPACKENCOPTS, APENCOPTS,
OGGENCOPTS, FLACOPTS, SPEEXENCOPTS, MPCENCOPTS, FAACENCOPTS, NEROAACENCOPTS, FDKAACENCOPTS,
OPUSENCOPTS, ID3OPTS, EYED3OPTS, MP3GAINOPTS, CDPARANOIAOPTS, CDDA2WAVOPTS, PIRDOPTS,
(Ogg/Vorbis), "mp3" (MPEG-1 Audio Layer III), "flac" (Free Lossless Audio
Codec), "mp2" (MPEG-1 Audio Layer III), "spx" (Ogg/Speex), "mpc" (MPP/MP+ (Musepack),
"m4a" (AAC or ALAC),"wv" (WavPack"), "wav" (Microsoft Waveform), "opus"
-(Opus Interactive Audio Codec), "tta" (True Audio) or "mka" (Matroska). Values like
-"vorbis,mp3" encode the tracks in both Ogg/Vorbis and MP3 formats. For example:
+(Opus Interactive Audio Codec), "tta" (True Audio), "mka" (Matroska) or
+"aiff" (Audio Interchange File Format). Values like "vorbis,mp3" encode
+the tracks in both Ogg/Vorbis and MP3 formats. For example:
.br
OUTPUTTYPE=vorbis,flac
.br
For each value in OUTPUTTYPE, \fBabcde\fR expands a different process for encoding,
tagging and moving, so you can use the format placeholder, OUTPUT, to create
different subdirectories to hold the different types. The variable OUTPUT will
-be 'vorbis', 'mp3', 'flac', 'spx', 'mpc', 'm4a', mp2, 'wv', 'ape', 'tta', 'wav'
-and/or 'mka' depending on the OUTPUTTYPE you define. For example
+be 'vorbis', 'mp3', 'flac', 'spx', 'mpc', 'm4a', mp2, 'wv', 'ape', 'tta', 'wav',
+'mka' and/or 'aiff' depending on the OUTPUTTYPE you define. For example
.br
OUTPUTFORMAT='${OUTPUT}/${ARTISTFILE}/${ALBUMFILE}/${TRACKNUM}._${TRACKFILE}'
.TP
from the CDROM, or to try to read the DATA areas from the CD (if any exist).
The default function is empty.
.TP
+.B post_encode
+post_encode () is a shell function which is executed after the encoding process.
+It can be used to move completed files to another location, run any sort of testing
+on the completed files or embed album art if the built in embedding provided by
+abcde's embedalbumart function is not to your taste.
+The default function is empty.
+.TP
.B EJECTCD
If set to "y", \fBabcde\fR will call \fBeject\fR(1) to eject the cdrom from the drive
after all tracks have been read. It has no effect when CDROM is set to a flac
Will pass "\-b 192" to the Ogg/Vorbis encoder, without having to modify the
config file
.TP
-.B abcde \-o mp3,flac,m4a -B
-abcde will create mp3, flac and m4a files and also select suitable album art,
-download and embed the album art into all 3 sets of tracks.
+.B abcde \-o mp3,flac,m4a,wv,ogg -B
+abcde will create mp3, flac, m4a, wv and ogg files and also select
+suitable album art, download and embed the album art into all 5 sets of tracks.
.TP
.B abcde \-W 1
For double+ CD settings: will create the 1st CD starting with the track number
.BR convert (1),
.BR wavpack (1),
.BR wvgain (1),
+.BR wvtag (1),
.BR id3 (1),
.BR eyeD3 (1),
.BR wget (1),