Encode to m4a container with either FFmpeg or avconv
[abcde.git] / FAQ
diff --git a/FAQ b/FAQ
index 1c0d1e5..b9f42dd 100644 (file)
--- a/FAQ
+++ b/FAQ
@@ -4,9 +4,11 @@
 Q. Who created abcde? Who develops it nowadays?
 A. It was originally created by Robert Woodcook. He decided to give up
    maintaining it at some point in 2002 and Jesus Climent took over. In 2012,
-   Colin Tuckley and Steve McIntyre joined in to help. Contact
-   jesus.climent@hispalinux.es, colint@debian.org or 93sam@debian.org if you
-   have a problem or a suggestion.
+   Colin Tuckley and Steve McIntyre joined in to help. Currently Steve maintains
+   abcde along with Andrew Strong. Contact either with comments or suggestions
+   at the following email addresses:
+      Steve McIntyre <93sam@@debian.org>
+      Andrew Strong <andrew.david.strong@gmail.com>
 
 
 1. INSTALLATION
@@ -192,7 +194,7 @@ A. Set CDDBMETHOD=musicbrainz and try it!
    ===================
 
 Q. Can abcde download album art?   
-A. As of abcde 2.6.1 it is possible to download a suitable cover
+A. As of abcde 2.7 it is possible to download a suitable cover
    image from within abcde that can be used by applications such
    as Audacious and vlc to illustrate playback with an album cover.
    Many hardware playback devices such as iPODs will also use this
@@ -284,21 +286,21 @@ A. The philosophy of getalbumart at the moment is to simply place the album
     ARTISTFILE="$(mungefilename "$TRACKARTIST")"
     ALBUMFILE="$(mungefilename "$DALBUM")"
 
-   if [ "$OUTPUTTYPE" = "mp3" ] && [ "$TAGGER" = "$EYED3" ] ; then
-    vecho "Preparing to embed the album art..." >&2
-   else
-    vecho "Not embedding album art, you need mp3 output and eyeD3 tagging..." >&2
-    return 1
-   fi
-
    if [ "$VARIOUSARTISTS" = "y" ] ; then
      FINDPATH="$(eval echo "$VAOUTPUTFORMAT")"
    else
      FINDPATH="$(eval echo "$OUTPUTFORMAT")"
    fi
 
-   TRIMPATH="$(dirname "$OUTPUTDIR/$FINDPATH")"
-   cd "$TRIMPATH"
+   FINALDIR="$(dirname "$OUTPUTDIR/$FINDPATH")"
+   cd "$FINALDIR"
+
+   if [ "$OUTPUTTYPE" = "mp3" ] && [ "$TAGGER" = "$EYED3" ] ; then
+    vecho "Preparing to embed the album art..." >&2
+   else
+    vecho "Not embedding album art, you need mp3 output and eyeD3 tagging..." >&2
+    return 1
+   fi
 
     if [ -e "cover.jpg" ] ; then
       for i in *.mp3
@@ -385,10 +387,35 @@ A. Faac uses mp4v2 to create aac files in an m4a or mp4 container. Some
    These streams should correctly have the .aac file extension and some 
    players (such as Audacious) will not even play mpeg-2/ADTS streams when
    they are placed in an .m4a container.
-   As of version 2.6.1 abcde tests the version of faac being used for mp4v2 
+   As of version 2.7 abcde tests the version of faac being used for mp4v2 
    support and then appropriately  places the audio either in .m4a or .aac. 
    Note that tagging is not possible with mpeg-2/ADTS streams in .aac.
+   
+Q. How do I encode to Apple Lossless Audio Codec (alac)?
+A. As of abcde 2.7.1 there are 3 ways to encode to alac: using qaac, refalac
+   or FFmpeg. To use qaac or refalac follow the installation directions here:
+
+   http://www.andrews-corner.org/qaac.html#installation
+
+   and then set your ~/.abcde.conf file as follows:
+
+   AACENCODERSYNTAX=qaac
+   QAAC="$HOME/.wine/drive_c/qaac/qaac.exe"
+   # Or use the Open Source alac encoder with this small hack:
+   # QAAC="$HOME/.wine/drive_c/qaac/refalac.exe"
+   QAACENCOPTS="--alac --threading --verbose"
+   OUTPUTTYPE="m4a"
+
+   To use FFmpeg (or avconv) set your ~/.abcde.conf file as follows:
+
+   AACENCODERSYNTAX=ffmpeg
+   FFMPEG=ffmpeg
+   # Or give the path to avconv instead:
+   # FFMPEG=avconv
+   FFMPEGENCOPTS="-c:a alac"
+   OUTPUTTYPE="m4a"
 
+  And then sit back and enjoy the music :) 
 
 5. USEPIPES
    ========
@@ -425,12 +452,13 @@ A. You can run USEPIPES in either of two ways:
 Q. Do all rippers and encoders work with USEPIPES?
 A. No :). Keep in mind that every ripper and encoder differs from in each
    other in the way they interact with pipes and not all rippers and encoders
-   will use or understand the '-o' and '-' options. Currently (May 2015) the
+   will use or understand the '-o' and '-' options. Currently (July 2015) the
    following rippers and encoders work:
 
    Rippers:  cdparanoia, debug, libcdio, cdda2wav, flac, pird.
    Encoders: mp3enc, lame, bladeenc, oggenc, opusenc, flac, speexenc,
-             mpcenc, wavpack, faac, neroAacEnc, fdkaac.
+             mpcenc, wavpack, faac, neroAacEnc, fdkaac, qaac, fhgaacenc,
+             ffmpeg.
 
 Q. Can I add a ripper or encoder which is not supported?
 A. Sure! If you plan to use a ripper or encoder which is not supported you