From 8705873533134ce10de287dd7ef7ffd365477346 Mon Sep 17 00:00:00 2001
From: LoRd_MuldeR <mulder2@gmx.de>
Date: Wed, 24 Dec 2014 17:50:16 +0100
Subject: [PATCH] Manual: Added QAAC install instructions.

---
 doc/Manual.html | 29 +++++++++++++++++++++++++----
 doc/Manual.md   | 41 ++++++++++++++++++++++++++++++++++++++---
 2 files changed, 63 insertions(+), 7 deletions(-)

diff --git a/doc/Manual.html b/doc/Manual.html
index 0c54edf4..3032b25e 100644
--- a/doc/Manual.html
+++ b/doc/Manual.html
@@ -45,7 +45,7 @@
 </ul></li>
 <li><a href="#install-the-aac-encoder"><span class="toc-section-number">3.2</span> Install the AAC Encoder</a><ul>
 <li><a href="#nero-digital-aac-encoder"><span class="toc-section-number">3.2.1</span> Nero Digital AAC Encoder</a></li>
-<li><a href="#qaacapple-aac-encoder"><span class="toc-section-number">3.2.2</span> QAAC/Apple AAC Encoder</a></li>
+<li><a href="#qaac-apple-aac-encoder"><span class="toc-section-number">3.2.2</span> QAAC (Apple AAC) Encoder</a></li>
 </ul></li>
 </ul></li>
 <li><a href="#tutorial-step-by-step-guide"><span class="toc-section-number">4</span> Tutorial (Step-by-Step Guide)</a><ul>
@@ -200,12 +200,33 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.<
 <p><img src="img/lamexp/setup_3a.png" alt="Figure" /></p>
 <p> <br />Now open the downloaded ZIP file with your favourite file archive software (we recommend using <a href="http://www.7-zip.org/">7-Zip</a> or <a href="http://www.rarlab.com/download.htm">WinRAR</a>) and navigate to the &quot;win32&quot; sub-directory.</p>
 <p><img src="img/lamexp/setup_3b.png" alt="Figure" /></p>
-<p> <br />Finally, <em>extract</em> all the three files <code>neroAacDec.exe</code>, <code>neroAacEnc.exe</code> and <code>neroAacTag.exe</code> into the LameXP installation directory. That is the directory where your LameXP executable file, i.e. <code>LameXP.exe</code>, is located.</p>
+<p> <br />Finally, <em>extract</em> all the three files <code>neroAacDec.exe</code>, <code>neroAacEnc.exe</code> and <code>neroAacTag.exe</code> into the LameXP installation directory. That is the directory where your LameXP executable file, i.e. the <code>LameXP.exe</code>, is located.</p>
 <p><em>Note:</em> By default, the LameXP installation directory is either <code>C:\Program Files (x86)\MuldeR\LameXP</code> or <code>C:\Program Files\MuldeR\LameXP</code>. However, this can be changed by the user during the setup process.</p>
 <p><img src="img/lamexp/setup_3c.png" alt="Figure" /></p>
 <p> <br />Once the required Nero AAC files have been put into the proper place, simply <em>restart</em> LameXP in order to enable the AAC encoding support!</p>
-<h3 id="qaacapple-aac-encoder"><span class="header-section-number">3.2.2</span> QAAC/Apple AAC Encoder</h3>
-<p><strong>TODO</strong></p>
+<h3 id="qaac-apple-aac-encoder"><span class="header-section-number">3.2.2</span> QAAC (Apple AAC) Encoder</h3>
+<p>Getting the Apple/QuickTime AAC encoder ready involves <em>two</em> separate steps: In the first place we will install the QAAC encoder, and in the second place we will install the Apple AAC encoder libraries.</p>
+<h4 id="install-qaac-encoder"><span class="header-section-number">3.2.2.1</span> Install QAAC Encoder</h4>
+<p>First of all, you need to download the <a href="https://github.com/nu774/qaac">QAAC</a> application, which provides a CLI font-end to the Apple/QuickTime AAC encoder. QAAC is provided as an <em>Add-in</em> for LameXP and is available from the following locations:</p>
+<ul>
+<li><a href="http://sourceforge.net/projects/lamexp/files/Miscellaneous/Add-ins/qaac/">http://sourceforge.net/projects/lamexp/files/Miscellaneous/Add-ins/qaac/</a><br /></li>
+<li><a href="http://muldersoft.com/misc/lamexp/add-ins/qaac/">http://muldersoft.com/misc/lamexp/add-ins/qaac/</a></li>
+</ul>
+<p> <br />Now open the downloaded ZIP file, e.g. <code>LameXP.qaac-addin.yyyy-mm-dd.zip</code>, with your favourite file archive software (we recommend using <a href="http://www.7-zip.org/">7-Zip</a> or <a href="http://www.rarlab.com/download.htm">WinRAR</a>) to find the required QAAC program files.</p>
+<p><em>Note:</em> The LameXP software generally expects the <strong>latest</strong> version of the QAAC add-in; and the QAAC add-in is designed to work with the <strong>latest</strong> version of the LameXP software.</p>
+<p><img src="img/lamexp/setup_4a.png" alt="Figure" /></p>
+<p> <br />Please <em>extract</em> all the three files, the program <code>qaac.exe</code> plus its DLLs <code>libsoxr.dll</code> and <code>libsoxconvolver.dll</code>, into the LameXP installation directory. That is the directory where your LameXP executable file, i.e. the <code>LameXP.exe</code>, is located.</p>
+<p><em>Note:</em> By default, the LameXP installation directory is either <code>C:\Program Files (x86)\MuldeR\LameXP</code> or <code>C:\Program Files\MuldeR\LameXP</code>. However, this can be changed by the user during the setup process.</p>
+<p><img src="img/lamexp/setup_4b.png" alt="Figure" /></p>
+<h4 id="install-apple-aac-encoder-libraries"><span class="header-section-number">3.2.2.2</span> Install Apple AAC Encoder Libraries</h4>
+<p>Next, the actual Apple/QuickTime AAC encoder libraries, which are part of the so-called &quot;Apple Application Support&quot; package, need to be installed on your computer. QAAC can <em>not</em> work without these libraries!</p>
+<p>The required &quot;Apple Application Support&quot; package is included, for example, in the official setup packages of <em>QuickTime</em> or <em>iTunes</em> for Windows, which can be obtained from the Apple web-site free of charge:</p>
+<ul>
+<li><a href="https://www.apple.com/quicktime/download/">https://www.apple.com/quicktime/download/</a></li>
+</ul>
+<p> <br />Since you usually do <strong>not</strong> want to <em>install</em> the complete QuickTime (or iTunes) software on your computer, please only <em>download</em> the QuickTime (or iTunes) setup package, but do <strong>not</strong> actually <em>run</em> the installer!</p>
+<p>Instead, open the QuickTimer setup program, i.e. <code>QuickTimeInstaller.exe</code>, with your favourite file archive software (we recommend using <a href="http://www.7-zip.org/">7-Zip</a> or <a href="http://www.rarlab.com/download.htm">WinRAR</a>) and <em>extract</em> the required <code>AppleApplicationSupport.msi</code> package.</p>
+<p><img src="img/lamexp/setup_4c.png" alt="Figure" /></p>
 <h1 id="tutorial-step-by-step-guide"><span class="header-section-number">4</span> Tutorial (Step-by-Step Guide)</h1>
 <p>This tutorial will teach you, step by step, how to convert your audio files using the LameXP software. The tutorial assumes that LameXP is already installed on your computer.</p>
 <h2 id="source-files"><span class="header-section-number">4.1</span> Source Files</h2>
diff --git a/doc/Manual.md b/doc/Manual.md
index 1651c0c2..c2da28b4 100644
--- a/doc/Manual.md
+++ b/doc/Manual.md
@@ -210,7 +210,7 @@ Now open the downloaded ZIP file with your favourite file archive software (we r
 ![Figure](img/lamexp/setup_3b.png)
 
 &nbsp;  
-Finally, *extract* all the three files ``neroAacDec.exe``, ``neroAacEnc.exe`` and ``neroAacTag.exe`` into the LameXP installation directory. That is the directory where your LameXP executable file, i.e. ``LameXP.exe``, is located.
+Finally, *extract* all the three files ``neroAacDec.exe``, ``neroAacEnc.exe`` and ``neroAacTag.exe`` into the LameXP installation directory. That is the directory where your LameXP executable file, i.e. the ``LameXP.exe``, is located.
 
 *Note:* By default, the LameXP installation directory is either ``C:\Program Files (x86)\MuldeR\LameXP`` or ``C:\Program Files\MuldeR\LameXP``. However, this can be changed by the user during the setup process.
 
@@ -220,10 +220,45 @@ Finally, *extract* all the three files ``neroAacDec.exe``, ``neroAacEnc.exe`` an
 Once the required Nero AAC files have been put into the proper place, simply *restart* LameXP in order to enable the AAC encoding support!
 
 
-### QAAC/Apple AAC Encoder ###
+### QAAC (Apple AAC) Encoder ###
 
-**TODO**
+Getting the Apple/QuickTime AAC encoder ready involves *two* separate steps: In the first place we will install the QAAC encoder, and in the second place we will install the Apple AAC encoder libraries.
 
+#### Install QAAC Encoder ####
+
+First of all, you need to download the [QAAC](https://github.com/nu774/qaac) application, which provides a CLI font-end to the Apple/QuickTime AAC encoder. QAAC is provided as an *Add-in* for LameXP and is available from the following locations:
+
+* <http://sourceforge.net/projects/lamexp/files/Miscellaneous/Add-ins/qaac/>
+* <http://muldersoft.com/misc/lamexp/add-ins/qaac/>
+
+&nbsp;  
+Now open the downloaded ZIP file, e.g. ``LameXP.qaac-addin.yyyy-mm-dd.zip``, with your favourite file archive software (we recommend using [7-Zip](http://www.7-zip.org/) or [WinRAR](http://www.rarlab.com/download.htm)) to find the required QAAC program files.
+
+*Note:* The LameXP software generally expects the **latest** version of the QAAC add-in; and the QAAC add-in is designed to work with the **latest** version of the LameXP software.
+
+![Figure](img/lamexp/setup_4a.png)
+
+&nbsp;  
+Please *extract* all the three files, the program ``qaac.exe`` plus its DLLs ``libsoxr.dll`` and ``libsoxconvolver.dll``, into the LameXP installation directory. That is the directory where your LameXP executable file, i.e. the ``LameXP.exe``, is located.
+
+*Note:* By default, the LameXP installation directory is either ``C:\Program Files (x86)\MuldeR\LameXP`` or ``C:\Program Files\MuldeR\LameXP``. However, this can be changed by the user during the setup process.
+
+![Figure](img/lamexp/setup_4b.png)
+
+#### Install Apple AAC Encoder Libraries ####
+
+Next, the actual Apple/QuickTime AAC encoder libraries, which are part of the so-called "Apple Application Support" package, need to be installed on your computer. QAAC can *not* work without these libraries!
+
+The required "Apple Application Support" package is included, for example, in the official setup packages of *QuickTime* or *iTunes* for Windows, which can be obtained from the Apple web-site free of charge:
+
+* <https://www.apple.com/quicktime/download/>
+
+&nbsp;  
+Since you usually do **not** want to *install* the complete QuickTime (or iTunes) software on your computer, please only *download* the QuickTime (or iTunes) setup package, but do **not** actually *run* the installer!
+
+Instead, open the QuickTimer setup program, i.e. ``QuickTimeInstaller.exe``, with your favourite file archive software (we recommend using [7-Zip](http://www.7-zip.org/) or [WinRAR](http://www.rarlab.com/download.htm)) and *extract* the required ``AppleApplicationSupport.msi`` package.
+
+![Figure](img/lamexp/setup_4c.png)
 
 
 Tutorial (Step-by-Step Guide)