Muldersoft/LameXP
Muldersoft/LameXP
1
0
Fork 0
Code Releases 2 Activity

Some documentation updates.

Browse Source
This commit is contained in:
LoRd_MuldeR 2015-01-14 22:43:28 +01:00
parent d92db7d5f9
commit 5b145b077f
5 changed files with 65 additions and 78 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
doc/Changelog.html
View File

@ -14,13 +14,16 @@
body { font-family: "Times New Roman", Times, serif; color: #000000; background-color: #FFFFFF; } body { font-family: "Times New Roman", Times, serif; color: #000000; background-color: #FFFFFF; }
p { text-align: justify; } p { text-align: justify; }
tt, pre, code { font-family: Courier New, Courier, mono; background-color: #EDF3F7; padding: 1px; } tt, pre, code { font-family: Courier New, Courier, mono; background-color: #EDF3F7; padding: 1px; }
h1:not(:first-child) { margin-top: 2.25em; } h1:not(.title) { margin-top: 2.25em; }
h2 { margin-top: 2.0em; } h2:not(.author) { margin-top: 2.0em; }
h3, h4 { margin-top: 1.75em; } h3, h4 { margin-top: 1.75em; }
a { color: #0000BB; text-decoration: none; } a { color: #0000BB; text-decoration: none; }
a:visited { color: #0000BB; text-decoration: none; } a:visited { color: #0000BB; text-decoration: none; }
a:active { color: #0000FF; text-decoration: none; } a:active { color: #0000FF; text-decoration: none; }
a:hover { color: #0000FF; text-decoration: underline; } a:hover { color: #0000FF; text-decoration: underline; }
img { margin-bottom: 0.75em; }
ul, ol { margin-bottom: 2.0em; }
li>ul, li>ol { margin-bottom: 0em; }
--> -->
</style> </style>
</head> </head>

86
doc/Manual.html
View File

@ -4,6 +4,7 @@
<meta charset="utf-8"> <meta charset="utf-8">
<meta name="generator" content="pandoc"> <meta name="generator" content="pandoc">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes"> <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes">
<meta name="author" content="Created by LoRd_MuldeR &lt;mulder2@gmx&gt; – check http://muldersoft.com/ for news and updates!">
<title>LameXP Audio-Encoder Front-End – Manual</title> <title>LameXP Audio-Encoder Front-End – Manual</title>
<style type="text/css">code{white-space: pre;}</style> <style type="text/css">code{white-space: pre;}</style>
<!--[if lt IE 9]> <!--[if lt IE 9]>
@ -14,19 +15,28 @@
body { font-family: "Times New Roman", Times, serif; color: #000000; background-color: #FFFFFF; } body { font-family: "Times New Roman", Times, serif; color: #000000; background-color: #FFFFFF; }
p { text-align: justify; } p { text-align: justify; }
tt, pre, code { font-family: Courier New, Courier, mono; background-color: #EDF3F7; padding: 1px; } tt, pre, code { font-family: Courier New, Courier, mono; background-color: #EDF3F7; padding: 1px; }
h1:not(:first-child) { margin-top: 2.25em; } h1:not(.title) { margin-top: 2.25em; }
h2 { margin-top: 2.0em; } h2:not(.author) { margin-top: 2.0em; }
h3, h4 { margin-top: 1.75em; } h3, h4 { margin-top: 1.75em; }
a { color: #0000BB; text-decoration: none; } a { color: #0000BB; text-decoration: none; }
a:visited { color: #0000BB; text-decoration: none; } a:visited { color: #0000BB; text-decoration: none; }
a:active { color: #0000FF; text-decoration: none; } a:active { color: #0000FF; text-decoration: none; }
a:hover { color: #0000FF; text-decoration: underline; } a:hover { color: #0000FF; text-decoration: underline; }
img { margin-bottom: 0.75em; }
ul, ol { margin-bottom: 2.0em; }
li>ul, li>ol { margin-bottom: 0em; }
--> -->
</style> </style>
</head> </head>
<body> <body>
<header> <header>
<h1 class="title">LameXP Audio-Encoder Front-End – Manual</h1> <h1 class="title">LameXP Audio-Encoder Front-End – Manual</h1>
<h2 class="author">Created by LoRd_MuldeR &lt;<script type="text/javascript">
<!--
h='&#x67;&#x6d;&#120;';a='&#64;';n='&#x6d;&#x75;&#108;&#100;&#x65;&#114;&#50;';e=n+a+h;
document.write('<a h'+'ref'+'="ma'+'ilto'+':'+e+'">'+e+'<\/'+'a'+'>');
// -->
</script><noscript>&#x6d;&#x75;&#108;&#100;&#x65;&#114;&#50;&#32;&#x61;&#116;&#32;&#x67;&#x6d;&#120;</noscript>&gt; – check <a href="http://muldersoft.com/">http://muldersoft.com/</a> for news and updates!</h2>
</header> </header>
<nav id="TOC"> <nav id="TOC">
<ul> <ul>
@ -123,7 +133,7 @@
<li>Microsoft Windows 98<br /></li> <li>Microsoft Windows 98<br /></li>
<li>Microsoft Windows 95</li> <li>Microsoft Windows 95</li>
</ul> </ul>
<p> <br /><em>Remarks:</em> Windows XP has reached &quot;end of life&quot; on April 8th, 2014. This means that Microsoft has stopped all support for Windows XP. Thus <strong>no</strong> updates or bugfixes are made available to regular Windows XP users since that date, <strong>not</strong> even security fixes! Thus, all the security vulnerabilities that have been discovered <em>after</em> the deadline – and all the security vulnerabilities that are going to be discovered in the future – will <em>persists</em> forever! Consequently, using Windows XP has become a severe security risk, and the situation is only going to get worse. While LameXP will continue to support Windows XP (note that Service Pack 3 is required!) for the foreseeable future, we <em>highly</em> recommend everybody to update to a less antiquated system now. Windows XP support will be discontinued in a future version, when most users have migrated to a contemporary system.</p> <p><em>Remarks:</em> Windows XP has reached &quot;end of life&quot; on April 8th, 2014. This means that Microsoft has stopped all support for Windows XP. Thus <strong>no</strong> updates or bugfixes are made available to regular Windows XP users since that date, <strong>not</strong> even security fixes! Thus, all the security vulnerabilities that have been discovered <em>after</em> the deadline – and all the security vulnerabilities that are going to be discovered in the future – will <em>persists</em> forever! Consequently, using Windows XP has become a severe security risk, and the situation is only going to get worse. While LameXP will continue to support Windows XP (note that Service Pack 3 is required!) for the foreseeable future, we <em>highly</em> recommend everybody to update to a less antiquated system now. Windows XP support will be discontinued in a future version, when most users have migrated to a contemporary system.</p>
<h2 id="output-formats-encoders"><span class="header-section-number">1.2</span> Output Formats (Encoders)</h2> <h2 id="output-formats-encoders"><span class="header-section-number">1.2</span> Output Formats (Encoders)</h2>
<p>Currently the following output formats (audio encoders) are supported by LameXP:</p> <p>Currently the following output formats (audio encoders) are supported by LameXP:</p>
<ul> <ul>
@ -190,7 +200,7 @@ GNU General Public License for more details.
You should have received a copy of the GNU General Public License You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</code></pre> Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</code></pre>
<p> <br /><strong>Addendum:</strong> When distributing binaries of the LameXP software, it is <em>strictly forbidden</em> to bundle the LameXP program files and/or the LameXP installation program with any kind of <em>Adware</em>, <em>Spyware</em> or <em>PUP (potentially unwanted program)</em>, including, but not limited to, any downloaders, dialers, browser toolbars/extensions or restricted shareware/demo programs. It is, however, perfectly legitimate to bundle LameXP with other <em>OpenSource</em> programs, according to the OSI (Open Source Initiative). Finally, it is also legitimate to bundle LameXP with <em>commercial software</em>, as long as that software does <em>not</em> meet the criteria of <em>Adware</em>, <em>Spyware</em> or <em>PUP</em>. If you bundle the LameXP software with another software, you are <em>required</em> to make sure that the user is provided with an easy way to install and start the LameXP software separately from that other software.</p> <p><strong>Addendum:</strong> When distributing binaries of the LameXP software, it is <em>strictly forbidden</em> to bundle the LameXP program files and/or the LameXP installation program with any kind of <em>Adware</em>, <em>Spyware</em> or <em>PUP (potentially unwanted program)</em>, including, but not limited to, any downloaders, dialers, browser toolbars/extensions or restricted shareware/demo programs. It is, however, perfectly legitimate to bundle LameXP with other <em>OpenSource</em> programs, according to the OSI (Open Source Initiative). Finally, it is also legitimate to bundle LameXP with <em>commercial software</em>, as long as that software does <em>not</em> meet the criteria of <em>Adware</em>, <em>Spyware</em> or <em>PUP</em>. If you bundle the LameXP software with another software, you are <em>required</em> to make sure that the user is provided with an easy way to install and start the LameXP software separately from that other software.</p>
<h1 id="anti-virus-notes"><span class="header-section-number">3</span> Anti-Virus Notes</h1> <h1 id="anti-virus-notes"><span class="header-section-number">3</span> Anti-Virus Notes</h1>
<p>Occasionally, it may happen that your anti-virus software <em>mistakenly</em> detects <a href="http://en.wikipedia.org/wiki/Malware">malware</a> (virus, trojan horse, worm, etc.) while you are trying to run the LameXP application or the LameXP setup program. This is called a <a href="http://en.wikipedia.org/wiki/Antivirus_software#Problems_caused_by_false_positives"><strong>false positive</strong></a> and the file actually is <strong>not</strong> malware. Instead, this is an error (bug) in your particular anti-virus software! In case that you encounter this kind problem, we highly recommend using <a href="http://www.virustotal.com/">VirusTotal.com</a>, <a href="http://www.virscan.org/">Virscan.org</a> or a similar web-service to check the file in question with <em>multiple</em> anti-virus engines. Unless the vast majority of the anti-virus engines detect malware, it can be assumed that the file is really harmless. However, please take care with <em>heuristic</em> scan results, such as &quot;suspicious&quot;, &quot;generic&quot; or &quot;packed&quot;. Those results are <strong>not</strong> confirmed malware detections – they are highly speculative and (almost certainly) can be ignored safely!</p> <p>Occasionally, it may happen that your anti-virus software <em>mistakenly</em> detects <a href="http://en.wikipedia.org/wiki/Malware">malware</a> (virus, trojan horse, worm, etc.) while you are trying to run the LameXP application or the LameXP setup program. This is called a <a href="http://en.wikipedia.org/wiki/Antivirus_software#Problems_caused_by_false_positives"><strong>false positive</strong></a> and the file actually is <strong>not</strong> malware. Instead, this is an error (bug) in your particular anti-virus software! In case that you encounter this kind problem, we highly recommend using <a href="http://www.virustotal.com/">VirusTotal.com</a>, <a href="http://www.virscan.org/">Virscan.org</a> or a similar web-service to check the file in question with <em>multiple</em> anti-virus engines. Unless the vast majority of the anti-virus engines detect malware, it can be assumed that the file is really harmless. However, please take care with <em>heuristic</em> scan results, such as &quot;suspicious&quot;, &quot;generic&quot; or &quot;packed&quot;. Those results are <strong>not</strong> confirmed malware detections – they are highly speculative and (almost certainly) can be ignored safely!</p>
<p>Defective anti-virus software is an ongoing annoyance! For example, anti-virus programs tend to suspect installers (or uninstallers) created with <a href="http://nsis.sourceforge.net/">NSIS</a> – which includes the LameXP setup program. But, of course, installers created with NSIS are perfectly legitimate. Thus, if your anti-virus program complains about the LameXP setup program, please ignore the <em>nonsensical</em> warning! Furthermore, it seems that some anti-virus programs accuse <em>all</em> &quot;packed&quot; executables of being malware. Nonetheless, using so-called &quot;executable packers&quot;, e.g. <a href="http://upx.sourceforge.net/">UPX</a>, is perfectly legitimate. Executable packers are commonly used by legitimate software, including numerous OpenSource projects – and so does LameXP. Thus, if your anti-virus program complains about the LameXP program file, because it has been &quot;packed&quot; by UPX, please ignore the <em>nonsensical</em> warning!</p> <p>Defective anti-virus software is an ongoing annoyance! For example, anti-virus programs tend to suspect installers (or uninstallers) created with <a href="http://nsis.sourceforge.net/">NSIS</a> – which includes the LameXP setup program. But, of course, installers created with NSIS are perfectly legitimate. Thus, if your anti-virus program complains about the LameXP setup program, please ignore the <em>nonsensical</em> warning! Furthermore, it seems that some anti-virus programs accuse <em>all</em> &quot;packed&quot; executables of being malware. Nonetheless, using so-called &quot;executable packers&quot;, e.g. <a href="http://upx.sourceforge.net/">UPX</a>, is perfectly legitimate. Executable packers are commonly used by legitimate software, including numerous OpenSource projects – and so does LameXP. Thus, if your anti-virus program complains about the LameXP program file, because it has been &quot;packed&quot; by UPX, please ignore the <em>nonsensical</em> warning!</p>
@ -219,19 +229,19 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.<
<p>Shortly after launching the setup program, an <a href="http://en.wikipedia.org/wiki/User_Account_Control">UAC</a> (User Access Control) dialogue may appear. This is a standard Windows security feature, so don't worry! You have to choose &quot;Yes&quot;, if you wish to continue the installation process.</p> <p>Shortly after launching the setup program, an <a href="http://en.wikipedia.org/wiki/User_Account_Control">UAC</a> (User Access Control) dialogue may appear. This is a standard Windows security feature, so don't worry! You have to choose &quot;Yes&quot;, if you wish to continue the installation process.</p>
<p><em>Note:</em> If you wonder why Windows suggests that the LameXP setup program originates from an &quot;unknown publisher&quot;, despite the fact that it was downloaded from the official web-site, then please the explanation <a href="http://lamexp.sourceforge.net/doc/Manual.html#q-why-are-the-lamexp-binaries-not-digitally-signed">here</a>!</p> <p><em>Note:</em> If you wonder why Windows suggests that the LameXP setup program originates from an &quot;unknown publisher&quot;, despite the fact that it was downloaded from the official web-site, then please the explanation <a href="http://lamexp.sourceforge.net/doc/Manual.html#q-why-are-the-lamexp-binaries-not-digitally-signed">here</a>!</p>
<p><img src="img/lamexp/setup_1a.png" alt="Figure" /></p> <p><img src="img/lamexp/setup_1a.png" alt="Figure" /></p>
<p> <br />Now simply follow the instructions of the setup wizard, which will guide you through the installation process…</p> <p>Now simply follow the instructions of the setup wizard, which will guide you through the installation process…</p>
<p><em>Note:</em> Please do <strong>not</strong> change the &quot;Destionation Folder&quot;, unless you know exactly what you are doing. The &quot;Destionation Folder&quot; cannot be changed, when <em>upgrading</em> an existing LameXP installation.</p> <p><em>Note:</em> Please do <strong>not</strong> change the &quot;Destionation Folder&quot;, unless you know exactly what you are doing. The &quot;Destionation Folder&quot; cannot be changed, when <em>upgrading</em> an existing LameXP installation.</p>
<p><img src="img/lamexp/setup_1b.png" alt="Figure" /></p> <p><img src="img/lamexp/setup_1b.png" alt="Figure" /></p>
<p> <br />Congratulation, LameXP has been installed successfully on your computer!</p> <p>Congratulation, LameXP has been installed successfully on your computer!</p>
<p><em>Note:</em> If you keep the &quot;Run LameXP …&quot; option enabled and click on the &quot;Finish&quot; button, the LameXP software will be launched immediately.</p> <p><em>Note:</em> If you keep the &quot;Run LameXP …&quot; option enabled and click on the &quot;Finish&quot; button, the LameXP software will be launched immediately.</p>
<p><img src="img/lamexp/setup_1c.png" alt="Figure" /></p> <p><img src="img/lamexp/setup_1c.png" alt="Figure" /></p>
<h3 id="zip-package"><span class="header-section-number">4.1.2</span> ZIP Package</h3> <h3 id="zip-package"><span class="header-section-number">4.1.2</span> ZIP Package</h3>
<p>If you decided for the <strong>ZIP package</strong>, you need to open the downloaded ZIP file, e.g. <code>LameXP.yyyy-mm-dd.Release-Static.Build-xxxx.zip</code>, in 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>).</p> <p>If you decided for the <strong>ZIP package</strong>, you need to open the downloaded ZIP file, e.g. <code>LameXP.yyyy-mm-dd.Release-Static.Build-xxxx.zip</code>, in 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>).</p>
<p><img src="img/lamexp/setup_2a.png" alt="Figure" /></p> <p><img src="img/lamexp/setup_2a.png" alt="Figure" /></p>
<p> <br />This step may be slightly different, depending on what file archive software (e.g. 7-Zip or WinRAR) you are using. Select <strong>all</strong> files in the LameXP ZIP archive and <em>extract</em> them to a new/empty directory of your choice.</p> <p>This step may be slightly different, depending on what file archive software (e.g. 7-Zip or WinRAR) you are using. Select <strong>all</strong> files in the LameXP ZIP archive and <em>extract</em> them to a new/empty directory of your choice.</p>
<p><em>Note:</em> It is very important that you have write-access to the chosen destination directory. So make sure that you choose a directory where the required access rights are granted!</p> <p><em>Note:</em> It is very important that you have write-access to the chosen destination directory. So make sure that you choose a directory where the required access rights are granted!</p>
<p><img src="img/lamexp/setup_2b.png" alt="Figure" /></p> <p><img src="img/lamexp/setup_2b.png" alt="Figure" /></p>
<p> <br />Congratulation, LameXP has been installed successfully on your computer! Now double-click on the <code>LameXP.exe</code> program file in order to launch the application!</p> <p>Congratulation, LameXP has been installed successfully on your computer! Now double-click on the <code>LameXP.exe</code> program file in order to launch the application!</p>
<p><img src="img/lamexp/setup_2c.png" alt="Figure" /></p> <p><img src="img/lamexp/setup_2c.png" alt="Figure" /></p>
<h2 id="portable-mode"><span class="header-section-number">4.2</span> Portable Mode</h2> <h2 id="portable-mode"><span class="header-section-number">4.2</span> Portable Mode</h2>
<p>First of all, it is important to note that there is <strong>no</strong> such thing as a <em>separate</em> &quot;portable version&quot; or &quot;portable edition&quot; of the LameXP software. Instead, <strong>all</strong> versions of the LameXP software always <em>are</em> &quot;portable&quot; – in the sense that the LameXP software is <em>fully self-contained</em> and thus <strong>no</strong> additional dependencies (libraries, frameworks, codecs or whatsoever) need to be installed on the computer separately. Or, in other words, the LameXP software is designed to work &quot;out of the box&quot;. And this applies regardless of whether you choose the setup program or the ZIP package!</p> <p>First of all, it is important to note that there is <strong>no</strong> such thing as a <em>separate</em> &quot;portable version&quot; or &quot;portable edition&quot; of the LameXP software. Instead, <strong>all</strong> versions of the LameXP software always <em>are</em> &quot;portable&quot; – in the sense that the LameXP software is <em>fully self-contained</em> and thus <strong>no</strong> additional dependencies (libraries, frameworks, codecs or whatsoever) need to be installed on the computer separately. Or, in other words, the LameXP software is designed to work &quot;out of the box&quot;. And this applies regardless of whether you choose the setup program or the ZIP package!</p>
@ -256,15 +266,15 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.<
<li><a href="http://www.nero.com/eng/company/about-nero/nero-aac-codec.php">http://www.nero.com/eng/company/about-nero/nero-aac-codec.php</a><br /></li> <li><a href="http://www.nero.com/eng/company/about-nero/nero-aac-codec.php">http://www.nero.com/eng/company/about-nero/nero-aac-codec.php</a><br /></li>
<li><a href="http://www.free-codecs.com/download/Nero_AAC_Codec.htm">http://www.free-codecs.com/download/Nero_AAC_Codec.htm</a></li> <li><a href="http://www.free-codecs.com/download/Nero_AAC_Codec.htm">http://www.free-codecs.com/download/Nero_AAC_Codec.htm</a></li>
</ul> </ul>
<p> <br />Simply scroll down, click the &quot;I agree&quot; button, and enter <code>user@example.com</code> when asked for an e-mail address. Finally, click the &quot;Download&quot; button, which initates the download of the required <code>NeroAACCodec-1.5.1.zip</code> file.</p> <p>Simply scroll down, click the &quot;I agree&quot; button, and enter <code>user@example.com</code> when asked for an e-mail address. Finally, click the &quot;Download&quot; button, which initates the download of the required <code>NeroAACCodec-1.5.1.zip</code> file.</p>
<p><em>Note:</em> Although the ZIP file is called <code>NeroAACCodec-1.5.1.zip</code>, it actually contains version <strong>1.5.4.0</strong> of the Nero AAC encoder software. Please check the included <code>changelog.txt</code> to verify this!</p> <p><em>Note:</em> Although the ZIP file is called <code>NeroAACCodec-1.5.1.zip</code>, it actually contains version <strong>1.5.4.0</strong> of the Nero AAC encoder software. Please check the included <code>changelog.txt</code> to verify this!</p>
<p><img src="img/lamexp/setup_4a.png" alt="Figure" /></p> <p><img src="img/lamexp/setup_4a.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>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_4b.png" alt="Figure" /></p> <p><img src="img/lamexp/setup_4b.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. the <code>LameXP.exe</code>, is located.</p> <p>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><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_4c.png" alt="Figure" /></p> <p><img src="img/lamexp/setup_4c.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> <p>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="qaac-apple-aac-encoder"><span class="header-section-number">4.3.2</span> QAAC (Apple AAC) Encoder</h3> <h3 id="qaac-apple-aac-encoder"><span class="header-section-number">4.3.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> <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" class="unnumbered">Install QAAC Encoder</h4> <h4 id="install-qaac-encoder" class="unnumbered">Install QAAC Encoder</h4>
@ -273,10 +283,10 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.<
<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://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> <li><a href="http://muldersoft.com/misc/lamexp/add-ins/qaac/">http://muldersoft.com/misc/lamexp/add-ins/qaac/</a></li>
</ul> </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>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. Make sure your files are up-to-date!</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. Make sure your files are up-to-date!</p>
<p><img src="img/lamexp/setup_5a.png" alt="Figure" /></p> <p><img src="img/lamexp/setup_5a.png" alt="Figure" /></p>
<p> <br />Please <em>extract</em> all the three files, the program <code>qaac.exe</code> plus its companion 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>Please <em>extract</em> all the three files, the program <code>qaac.exe</code> plus its companion 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><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_5b.png" alt="Figure" /></p> <p><img src="img/lamexp/setup_5b.png" alt="Figure" /></p>
<h4 id="install-apple-aac-encoder-libraries" class="unnumbered">Install Apple AAC Encoder Libraries</h4> <h4 id="install-apple-aac-encoder-libraries" class="unnumbered">Install Apple AAC Encoder Libraries</h4>
@ -286,52 +296,54 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.<
<li><a href="https://www.apple.com/quicktime/download/">https://www.apple.com/quicktime/download/</a><br /></li> <li><a href="https://www.apple.com/quicktime/download/">https://www.apple.com/quicktime/download/</a><br /></li>
<li><a href="https://www.apple.com/itunes/download/">https://www.apple.com/itunes/download/</a></li> <li><a href="https://www.apple.com/itunes/download/">https://www.apple.com/itunes/download/</a></li>
</ul> </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>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>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_5c.png" alt="Figure" /></p> <p><img src="img/lamexp/setup_5c.png" alt="Figure" /></p>
<p> <br />After the &quot;Apple Application Support&quot; setup package has been extracted, you can launch it by double-clicking on the <code>AppleApplicationSupport.msi</code> file. Then simply follow the installer's instructions.</p> <p>After the &quot;Apple Application Support&quot; setup package has been extracted, you can launch it by double-clicking on the <code>AppleApplicationSupport.msi</code> file. Then simply follow the installer's instructions.</p>
<p><img src="img/lamexp/setup_5d.png" alt="Figure" /></p> <p><img src="img/lamexp/setup_5d.png" alt="Figure" /></p>
<p> <br />Once the QAAC encoder as well as the Apple AAC encoder libraries (&quot;Apple Application Support&quot;) have been installed properly, simply <em>restart</em> LameXP in order to enable the AAC encoding support!</p> <p>Once the QAAC encoder as well as the Apple AAC encoder libraries (&quot;Apple Application Support&quot;) have been installed properly, simply <em>restart</em> LameXP in order to enable the AAC encoding support!</p>
<p><em>Note:</em> You may run <code>qaac.exe --check</code> from the <a href="http://en.wikipedia.org/wiki/Cmd.exe">command prompt</a> to ensure that QAAC has been set up correctly. Expected output is <code>qaac 2.xx, CoreAudioToolbox x.x.x.x</code>.</p> <p><em>Note:</em> You may run <code>qaac.exe --check</code> from the <a href="http://en.wikipedia.org/wiki/Cmd.exe">command prompt</a> to ensure that QAAC has been set up correctly. Expected output is <code>qaac 2.xx, CoreAudioToolbox x.x.x.x</code>.</p>
<h1 id="tutorial-step-by-step-guide"><span class="header-section-number">5</span> Tutorial (Step-by-Step Guide)</h1> <h1 id="tutorial-step-by-step-guide"><span class="header-section-number">5</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> <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">5.1</span> Source Files</h2> <h2 id="source-files"><span class="header-section-number">5.1</span> Source Files</h2>
<p>First of all, you need to add all <strong>source files</strong> that you want to convert. So switch to the &quot;Source Files&quot; tab, just in case that tab is not active already, and then click the &quot;Add File(s)&quot; button.</p> <p>First of all, you need to add all <strong>source files</strong> that you want to convert. So switch to the &quot;Source Files&quot; tab, just in case that tab is not active already, and then click the &quot;Add File(s)&quot; button.</p>
<p><img src="img/lamexp/tutorial_1a.png" alt="Figure" /></p> <p><img src="img/lamexp/tutorial_1a.png" alt="Figure" /></p>
<p> <br />This will bring up a standard file selection dialogue. Now simply select the files that you want to add and click the &quot;Open&quot; button. You can repeat this step multiple times, e.g. to add files from different directories.</p> <p>This will bring up a standard file selection dialogue. Now simply select the files that you want to add and click the &quot;Open&quot; button. You can repeat this step multiple times, e.g. to add files from different directories.</p>
<p><img src="img/lamexp/tutorial_1b.png" alt="Figure" /></p> <p><img src="img/lamexp/tutorial_1b.png" alt="Figure" /></p>
<p> <br />All files you have added, so far, will show up in the list. You can click the &quot;Remove&quot; button to remove a single file from the list or &quot;Clear&quot; to remove them all. Click the &quot;Show details&quot; button to show details about a file.</p> <p>All files you have added, so far, will show up in the list. You can click the &quot;Remove&quot; button to remove a single file from the list or &quot;Clear&quot; to remove them all. You can also click the &quot;Show details&quot; button to show details about the selected file.</p>
<p><img src="img/lamexp/tutorial_1c.png" alt="Figure" /></p> <p><img src="img/lamexp/tutorial_1c.png" alt="Figure" /></p>
<p> <br /><em>Did you know?</em> Files can also be added via <a href="http://en.wikipedia.org/wiki/Drag_and_drop">Drag &amp; Drop</a>. Just grab the files that you want to add in your Explorer window and drop them onto the LameXP main window (or onto the LameXP &quot;dropbox&quot; widget).</p> <p>If you want to add an <em>entire</em> directory, you can select &quot;Open Folder&quot; from the &quot;File&quot; menu, which will bring up a directory selection dialogue. &quot;Open Folder Recursively&quot; works in a similar way, but also includes <em>all</em> sub-directories.</p>
<p><img src="img/lamexp/tutorial_1d.png" alt="Figure" /></p>
<p><em>Did you know?</em> Files can also be added via <a href="http://en.wikipedia.org/wiki/Drag_and_drop">Drag &amp; Drop</a>. Just grab the files that you want to add in your Explorer window and drop them onto the LameXP main window (or onto the LameXP &quot;dropbox&quot; widget).</p>
<h2 id="output-directory"><span class="header-section-number">5.2</span> Output Directory</h2> <h2 id="output-directory"><span class="header-section-number">5.2</span> Output Directory</h2>
<p>Next, you need to choose the <strong>output directory</strong>, i.e. the directory where the converted files will be saved. Switch to the &quot;Output Directory&quot; tab and choose the desired output directory from the directory tree view.</p> <p>Next, you need to choose the <strong>output directory</strong>, i.e. the directory where the converted files will be saved. Switch to the &quot;Output Directory&quot; tab and choose the desired output directory from the directory tree view.</p>
<p><em>Note:</em> There are several quick navigation buttons below, which will allow you to jump quickly to your personal &quot;Home&quot; folder, &quot;Desktop&quot; folder and &quot;Music&quot; folder, respectively.</p> <p><em>Note:</em> There are several quick navigation buttons below, which will allow you to jump quickly to your personal &quot;Home&quot; folder, &quot;Desktop&quot; folder and &quot;Music&quot; folder, respectively.</p>
<p><img src="img/lamexp/tutorial_2a.png" alt="Figure" /></p> <p><img src="img/lamexp/tutorial_2a.png" alt="Figure" /></p>
<p> <br />Sometimes you may wish to store the converted files in a <em>new</em> (sub-)folder. In this case, simply click the &quot;Make New Folder&quot; button, enter the desired folder name and hit the &quot;OK&quot; button.</p> <p>Sometimes you may wish to store the converted files in a <em>new</em> (sub-)folder. In this case, simply click the &quot;Make New Folder&quot; button, enter the desired folder name and hit the &quot;OK&quot; button.</p>
<p><img src="img/lamexp/tutorial_2b.png" alt="Figure" /></p> <p><img src="img/lamexp/tutorial_2b.png" alt="Figure" /></p>
<p> <br />The new folder is going to be created inside the current directory and will be selected automatically. You can repeat this step multiple times in order to created nested sub-folders.</p> <p>The new folder is going to be created inside the current directory and will be selected automatically. You can repeat this step multiple times in order to created nested sub-folders.</p>
<p><img src="img/lamexp/tutorial_2c.png" alt="Figure" /></p> <p><img src="img/lamexp/tutorial_2c.png" alt="Figure" /></p>
<p> <br /><em>Did you know?</em> If you enable the &quot;Save output files in the same directory where the input file is located&quot; option, each output file will be saved to the same location where the corresponding source file resides.</p> <p><em>Did you know?</em> If you enable the &quot;Save output files in the same directory where the input file is located&quot; option, each output file will be saved to the same location where the corresponding source file resides.</p>
<h2 id="compression-settings"><span class="header-section-number">5.3</span> Compression Settings</h2> <h2 id="compression-settings"><span class="header-section-number">5.3</span> Compression Settings</h2>
<p>Finally, you need to choose your <strong>compression settings</strong>. First, and most important, you must decide for an output <em>audio format (encoder)</em>. Depending on your needs and preferences, you can choose between <a href="http://en.wikipedia.org/wiki/MP3">MP3</a>, <a href="http://en.wikipedia.org/wiki/Vorbis">Ogg/Vorbis</a>, <a href="http://en.wikipedia.org/wiki/Opus_%28audio_format%29">Opus</a>, <a href="http://en.wikipedia.org/wiki/Advanced_Audio_Coding">AAC/MP4</a>, <a href="https://xiph.org/flac/">FLAC</a> and others.</p> <p>Finally, you need to choose your <strong>compression settings</strong>. First, and most important, you must decide for an output <em>audio format (encoder)</em>. Depending on your needs and preferences, you can choose between <a href="http://en.wikipedia.org/wiki/MP3">MP3</a>, <a href="http://en.wikipedia.org/wiki/Vorbis">Ogg/Vorbis</a>, <a href="http://en.wikipedia.org/wiki/Opus_%28audio_format%29">Opus</a>, <a href="http://en.wikipedia.org/wiki/Advanced_Audio_Coding">AAC/MP4</a>, <a href="https://xiph.org/flac/">FLAC</a> and others.</p>
<p><em>Note:</em> If you are uncertain which audio format to choose, then <a href="http://lifehacker.com/5927052/whats-the-difference-between-all-these-audio-formats-and-which-one-should-i-use">this article</a> by Lifehacker is a good starting point. Also see the <a href="http://en.wikipedia.org/wiki/Comparison_of_audio_coding_formats">comparison of audio coding formats</a> on Wikipedia. If still uncertain, just go with good old MP3 😉</p> <p><em>Note:</em> If you are uncertain which audio format to choose, then <a href="http://lifehacker.com/5927052/whats-the-difference-between-all-these-audio-formats-and-which-one-should-i-use">this article</a> by Lifehacker is a good starting point. Also see the <a href="http://en.wikipedia.org/wiki/Comparison_of_audio_coding_formats">comparison of audio coding formats</a> on Wikipedia. If still uncertain, just go with good old MP3 😉</p>
<p><img src="img/lamexp/tutorial_3a.png" alt="Figure" /></p> <p><img src="img/lamexp/tutorial_3a.png" alt="Figure" /></p>
<p> <br />Once you have decided for an audio format, you need to choose a <em>rate-control</em> mode next. The available rate-control modes include VBR (quality-base variable bitrate), ABR (average bitrate) and CBR (constant bitrate). Not all modes are available for all audio formats.</p> <p>Once you have decided for an audio format, you need to choose a <em>rate-control</em> mode next. The available rate-control modes include VBR (quality-base variable bitrate), ABR (average bitrate) and CBR (constant bitrate). Not all modes are available for all audio formats.</p>
<p><em>Note:</em> If you are uncertain which rate-control mode to chose, the guideline is that VBR mode should be preferred over ABR mode whenever possible. And CBR mode generally should be avoided. See also Wikipedia's article on <a href="http://en.wikipedia.org/wiki/Variable_bitrate">variable bitrate</a> encoding.</p> <p><em>Note:</em> If you are uncertain which rate-control mode to chose, the guideline is that VBR mode should be preferred over ABR mode whenever possible. And CBR mode generally should be avoided. See also Wikipedia's article on <a href="http://en.wikipedia.org/wiki/Variable_bitrate">variable bitrate</a> encoding.</p>
<p><img src="img/lamexp/tutorial_3b.png" alt="Figure" /></p> <p><img src="img/lamexp/tutorial_3b.png" alt="Figure" /></p>
<p> <br />Last but not least, you need to choose the desired target <em>bitrate</em> or <em>quality-level</em>. Put simply, this controls the &quot;quality vs. file size&quot; trade-off. You choose a target quality-level in case of VBR mode, and you choose a target (average) bitrate in case of ABR or CBR mode.</p> <p>Last but not least, you need to choose the desired target <em>bitrate</em> or <em>quality-level</em>. Put simply, this controls the &quot;quality vs. file size&quot; trade-off. You choose a target quality-level in case of VBR mode, and you choose a target (average) bitrate in case of ABR or CBR mode.</p>
<p><em>Note:</em> If you are uncertain which bitrate or quality-level to choose, bare in mind that a higher bitrate (or a better quality level) results in better audio quality, but also produces larger files – and vice versa. &quot;Level 2&quot; or &quot;192 kbps&quot; is a typical choice for MP3.</p> <p><em>Note:</em> If you are uncertain which bitrate or quality-level to choose, bare in mind that a higher bitrate (or a better quality level) results in better audio quality, but also produces larger files – and vice versa. &quot;Level 2&quot; or &quot;192 kbps&quot; is a typical choice for MP3.</p>
<p><img src="img/lamexp/tutorial_3c.png" alt="Figure" /></p> <p><img src="img/lamexp/tutorial_3c.png" alt="Figure" /></p>
<p> <br /><em>Did you know?</em> You can click on the &quot;Reset&quot; link at any time in order to reset all available settings for all available encoders to their factory defaults.</p> <p><em>Did you know?</em> You can click on the &quot;Reset&quot; link at any time in order to reset all available settings for all available encoders to their factory defaults.</p>
<h2 id="file-processing"><span class="header-section-number">5.4</span> File Processing</h2> <h2 id="file-processing"><span class="header-section-number">5.4</span> File Processing</h2>
<p>When everything has been set up properly, the time has come to actually start the encoding process. So simply click the &quot;Encode Now&quot; button in order to get going!</p> <p>When everything has been set up properly, the time has come to actually start the encoding process. So simply click the &quot;Encode Now&quot; button in order to get going!</p>
<p><img src="img/lamexp/tutorial_4a.png" alt="Figure" /></p> <p><img src="img/lamexp/tutorial_4a.png" alt="Figure" /></p>
<p> <br />This will bring up the &quot;Processing&quot; dialogue. LameXP will now convert all your audio files on the list. Depending on the number of audio files and depending on the performance of your system, this may take several minutes, so please be patient 😉</p> <p>This will bring up the &quot;Processing&quot; dialogue. LameXP will now convert all your audio files on the list. Depending on the number of audio files and depending on the performance of your system, this may take several minutes, so please be patient 😉</p>
<p><em>Note:</em> In order to leverage the power &quot;multi-core&quot; processors and thus massively speed-up the encoding process, LameXP will run multiple encoding jobs in parallel – provided that your system has multiple processor cores and that there are enough encoding jobs left in the queue.</p> <p><em>Note:</em> In order to leverage the power &quot;multi-core&quot; processors and thus massively speed-up the encoding process, LameXP will run multiple encoding jobs in parallel – provided that your system has multiple processor cores and that there are enough encoding jobs left in the queue.</p>
<p><img src="img/lamexp/tutorial_4b.png" alt="Figure" /></p> <p><img src="img/lamexp/tutorial_4b.png" alt="Figure" /></p>
<p> <br />The &quot;Processing&quot; dialogue is going to turn <em>green</em>, as soon as all encoding jobs have finished successfully. If anything went wrong, e.g. if one of the encoding jobs failed for some reason, it will turn <em>red</em> instead.</p> <p>The &quot;Processing&quot; dialogue is going to turn <em>green</em>, as soon as all encoding jobs have finished successfully. If anything went wrong, e.g. if one of the encoding jobs failed for some reason, it will turn <em>red</em> instead.</p>
<p><img src="img/lamexp/tutorial_4c.png" alt="Figure" /></p> <p><img src="img/lamexp/tutorial_4c.png" alt="Figure" /></p>
<p> <br /><em>Did you know?</em> You can double-click on a completed (or failed) job in the list, in order to bring up a dialogue with all details about the specific job. This is especially useful, if something went wrong.</p> <p><em>Did you know?</em> You can double-click on a completed (or failed) job in the list, in order to bring up a dialogue with all details about the specific job. This is especially useful, if something went wrong.</p>
<h1 id="command-line-usage"><span class="header-section-number">6</span> Command-line Usage</h1> <h1 id="command-line-usage"><span class="header-section-number">6</span> Command-line Usage</h1>
<p>Additional <strong><a href="http://en.wikipedia.org/wiki/Command-line_interface">command-line</a> options</strong> may be passed to LameXP when launching the application. You may do so, for example, by typing the complete command-line into the <a href="http://en.wikipedia.org/wiki/Cmd.exe"><em>command prompt</em></a> or by creating a <a href="http://en.wikipedia.org/wiki/File_shortcut"><em>shortcut</em></a> with the desired command-line options. The basic command-line syntax of LameXP is as follows: Each command-line option has to start with a <code>--</code> prefix. So if you intend to pass the option called &quot;foo&quot;, then you actually need to type <code>--foo</code>. Furthermore, while some command-line options are just <em>flags</em>, i.e. they can either be present or not (but that's it!), there also are command-line options that take an <em>argument</em>. The argument is <em>appended</em> directly to the option name to which it belongs to, but a <code>=</code> sign <strong>must</strong> to be inserted as a separator. If, for example, you wish to set the command-line option &quot;foo&quot; to an argument value of &quot;bar&quot;, then the proper syntax is <code>--foo=bar</code>. Sometimes your argument value may contain <em>whitespaces</em> though, in which case the <em>whole</em> command-line option (name + argument) <strong>must</strong> be enclosed with double quotes. For example, in order to set the option &quot;foo&quot; to a value of &quot;C:\Some File.bar&quot; (note the space character between &quot;Some&quot; and &quot;File&quot;), the proper syntax is <code>&quot;--foo=C:\Some File.bar&quot;</code>. Last but not least, please note that the <em>same</em> command-line option may appear <em>multiple</em> times on the command-line – whether that actually makes any sense depends on the individual option though.</p> <p>Additional <strong><a href="http://en.wikipedia.org/wiki/Command-line_interface">command-line</a> options</strong> may be passed to LameXP when launching the application. You may do so, for example, by typing the complete command-line into the <a href="http://en.wikipedia.org/wiki/Cmd.exe"><em>command prompt</em></a> or by creating a <a href="http://en.wikipedia.org/wiki/File_shortcut"><em>shortcut</em></a> with the desired command-line options. The basic command-line syntax of LameXP is as follows: Each command-line option has to start with a <code>--</code> prefix. So if you intend to pass the option called &quot;foo&quot;, then you actually need to type <code>--foo</code>. Furthermore, while some command-line options are just <em>flags</em>, i.e. they can either be present or not (but that's it!), there also are command-line options that take an <em>argument</em>. The argument is <em>appended</em> directly to the option name to which it belongs to, but a <code>=</code> sign <strong>must</strong> to be inserted as a separator. If, for example, you wish to set the command-line option &quot;foo&quot; to an argument value of &quot;bar&quot;, then the proper syntax is <code>--foo=bar</code>. Sometimes your argument value may contain <em>whitespaces</em> though, in which case the <em>whole</em> command-line option (name + argument) <strong>must</strong> be enclosed with double quotes. For example, in order to set the option &quot;foo&quot; to a value of &quot;C:\Some File.bar&quot; (note the space character between &quot;Some&quot; and &quot;File&quot;), the proper syntax is <code>&quot;--foo=C:\Some File.bar&quot;</code>. Last but not least, please note that the <em>same</em> command-line option may appear <em>multiple</em> times on the command-line – whether that actually makes any sense depends on the individual option though.</p>
<h2 id="add-files-andor-folders"><span class="header-section-number">6.1</span> Add Files and/or Folders</h2> <h2 id="add-files-andor-folders"><span class="header-section-number">6.1</span> Add Files and/or Folders</h2>
@ -385,7 +397,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.<
<li><a href="http://www.free-codecs.com/lamexp_download.htm">http://www.free-codecs.com/lamexp_download.htm</a><br /></li> <li><a href="http://www.free-codecs.com/lamexp_download.htm">http://www.free-codecs.com/lamexp_download.htm</a><br /></li>
<li><a href="http://www.videohelp.com/tools/LameXP">http://www.videohelp.com/tools/LameXP</a></li> <li><a href="http://www.videohelp.com/tools/LameXP">http://www.videohelp.com/tools/LameXP</a></li>
</ul> </ul>
<p> <br />It is <em>highly recommended</em> to download LameXP <em>only</em> from one of the official mirrors listed above. We are <strong>not</strong> responsible for the integrity and trustworthiness of LameXP downloads you may have received from other locations!</p> <p>It is <em>highly recommended</em> to download LameXP <em>only</em> from one of the official mirrors listed above. We are <strong>not</strong> responsible for the integrity and trustworthiness of LameXP downloads you may have received from other locations!</p>
<h2 id="diagnostic-output"><span class="header-section-number">7.2</span> Diagnostic Output</h2> <h2 id="diagnostic-output"><span class="header-section-number">7.2</span> Diagnostic Output</h2>
<p>If you want to report any problems that you have encountered with the LameXP software, please provide as much details as possible. <em>Diagnostic output</em> can be especially helpful here!</p> <p>If you want to report any problems that you have encountered with the LameXP software, please provide as much details as possible. <em>Diagnostic output</em> can be especially helpful here!</p>
<ul> <ul>
@ -394,20 +406,20 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.<
<li><p>If the debug console is <strong>not</strong> enabled, you may still use the <a href="http://technet.microsoft.com/en-us/sysinternals/bb896647.aspx"><em>DebugView</em></a> utility, by Mark Russinovich, in order to show and/or capture LameXP's diagnostic output.</p></li> <li><p>If the debug console is <strong>not</strong> enabled, you may still use the <a href="http://technet.microsoft.com/en-us/sysinternals/bb896647.aspx"><em>DebugView</em></a> utility, by Mark Russinovich, in order to show and/or capture LameXP's diagnostic output.</p></li>
<li><p>In any case, the <a href="http://en.wikipedia.org/wiki/Environment_variable">environment variable</a> <code>MUTILS_LOGFILE</code> may be used to specify a <em>log file</em> that will be created by LameXP. The information saved to the log file are the same as those available from the debug console.</p></li> <li><p>In any case, the <a href="http://en.wikipedia.org/wiki/Environment_variable">environment variable</a> <code>MUTILS_LOGFILE</code> may be used to specify a <em>log file</em> that will be created by LameXP. The information saved to the log file are the same as those available from the debug console.</p></li>
</ul> </ul>
<p> <br /><em>Note:</em> We highly recommend using a web-service like <a href="https://gist.github.com/">Gist</a>, <a href="http://pastie.org/">Pastie</a> or <a href="http://pastebin.com/">Pastebin</a> in order to share your diagnostic information. Please avoid posting long log files directly on the forums!</p> <p><em>Note:</em> We highly recommend using a web-service like <a href="https://gist.github.com/">Gist</a>, <a href="http://pastie.org/">Pastie</a> or <a href="http://pastebin.com/">Pastebin</a> in order to share your diagnostic information. Please avoid posting long log files directly on the forums!</p>
<h2 id="bugtracker"><span class="header-section-number">7.3</span> Bugtracker</h2> <h2 id="bugtracker"><span class="header-section-number">7.3</span> Bugtracker</h2>
<p>The recommended way to submit <em>bug reports</em> or <em>feature requests</em> to the LameXP developers is using the <em>issue tracking system</em> at our GitHub project site:</p> <p>The recommended way to submit <em>bug reports</em> or <em>feature requests</em> to the LameXP developers is using the <em>issue tracking system</em> at our GitHub project site:</p>
<ul> <ul>
<li><a href="https://github.com/lordmulder/LameXP/issues">https://github.com/lordmulder/LameXP/issues</a></li> <li><a href="https://github.com/lordmulder/LameXP/issues">https://github.com/lordmulder/LameXP/issues</a></li>
</ul> </ul>
<p> <br /><em>Note:</em> In order to use the issue tracking system, you need to log in with your GitHub account. Creating a GitHub account is easy and completely free of charge, simply click <a href="https://github.com/join">here</a>!</p> <p><em>Note:</em> In order to use the issue tracking system, you need to log in with your GitHub account. Creating a GitHub account is easy and completely free of charge, simply click <a href="https://github.com/join">here</a>!</p>
<h2 id="support-forum"><span class="header-section-number">7.4</span> Support Forum</h2> <h2 id="support-forum"><span class="header-section-number">7.4</span> Support Forum</h2>
<p>If you want to discuss the development of the LameXP software, help other users or receive help from other users, please use the LameXP thread at <em>Doom9's</em> Forum:</p> <p>If you want to discuss the development of the LameXP software, help other users or receive help from other users, please use the LameXP thread at <em>Doom9's</em> Forum:</p>
<ul> <ul>
<li><a href="http://forum.doom9.org/showthread.php?t=157726">http://forum.doom9.org/showthread.php?t=157726</a> – English<br /></li> <li><a href="http://forum.doom9.org/showthread.php?t=157726">http://forum.doom9.org/showthread.php?t=157726</a> – English<br /></li>
<li><a href="http://forum.gleitz.info/showthread.php?t=37956">http://forum.gleitz.info/showthread.php?t=37956</a> – German</li> <li><a href="http://forum.gleitz.info/showthread.php?t=37956">http://forum.gleitz.info/showthread.php?t=37956</a> – German</li>
</ul> </ul>
<p> <br /><em>Note:</em> Due to the massive amount of spam attacks, Doom9 has established strict anti-spam measures. Therefore, it takes a few days until your account will be approved.</p> <p><em>Note:</em> Due to the massive amount of spam attacks, Doom9 has established strict anti-spam measures. Therefore, it takes a few days until your account will be approved.</p>
<h1 id="developer-center"><span class="header-section-number">8</span> Developer Center</h1> <h1 id="developer-center"><span class="header-section-number">8</span> Developer Center</h1>
<p>While LameXP originally was written in Delphi/Pascal, the current version 4 series of the software has been re-written in the <a href="http://en.wikipedia.org/wiki/C%2B%2B"><strong>C++</strong></a> programming language. LameXP v4 uses the <a href="http://www.qt.io/"><em>Qt cross-platform application framework</em></a> and provides full <a href="http://en.wikipedia.org/wiki/Unicode"><em>Unicode</em></a> support. Furthermore, LameXP is tightly coupled with the <a href="https://github.com/lordmulder/MUtilities"><em>MUtilities</em></a> library, a vast collection of &quot;utility&quot; routines and classes to extend the Qt framework. Build files are currently provided for <em>Microsoft Visual Studio</em> only. Linux support is currently provided via <a href="https://www.winehq.org/"><em>Wine</em></a>; a native Linux port of LameXP is planned for a future version.</p> <p>While LameXP originally was written in Delphi/Pascal, the current version 4 series of the software has been re-written in the <a href="http://en.wikipedia.org/wiki/C%2B%2B"><strong>C++</strong></a> programming language. LameXP v4 uses the <a href="http://www.qt.io/"><em>Qt cross-platform application framework</em></a> and provides full <a href="http://en.wikipedia.org/wiki/Unicode"><em>Unicode</em></a> support. Furthermore, LameXP is tightly coupled with the <a href="https://github.com/lordmulder/MUtilities"><em>MUtilities</em></a> library, a vast collection of &quot;utility&quot; routines and classes to extend the Qt framework. Build files are currently provided for <em>Microsoft Visual Studio</em> only. Linux support is currently provided via <a href="https://www.winehq.org/"><em>Wine</em></a>; a native Linux port of LameXP is planned for a future version.</p>
<h2 id="source-code-access"><span class="header-section-number">8.1</span> Source Code Access</h2> <h2 id="source-code-access"><span class="header-section-number">8.1</span> Source Code Access</h2>
@ -421,7 +433,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.<
<li><p><code>git clone git://gitorious.org/lamexp/lamexp.git LameXP</code> (<a href="http://gitorious.org/lamexp/lamexp/trees/master">Browse</a>)</p></li> <li><p><code>git clone git://gitorious.org/lamexp/lamexp.git LameXP</code> (<a href="http://gitorious.org/lamexp/lamexp/trees/master">Browse</a>)</p></li>
<li><p><code>git clone git://repo.or.cz/LameXP.git LameXP</code> (<a href="http://repo.or.cz/w/LameXP.git">Browse</a>)</p></li> <li><p><code>git clone git://repo.or.cz/LameXP.git LameXP</code> (<a href="http://repo.or.cz/w/LameXP.git">Browse</a>)</p></li>
</ul> </ul>
<p> <br />The source code of the <strong>MUtilities</strong> library is managed using the <a href="http://git-scm.com/"><em>Git</em></a> version control system. The Git repository can be <em>cloned</em> from one of the official Git mirrors:</p> <p>The source code of the <strong>MUtilities</strong> library is managed using the <a href="http://git-scm.com/"><em>Git</em></a> version control system. The Git repository can be <em>cloned</em> from one of the official Git mirrors:</p>
<ul> <ul>
<li><p><code>git clone git://git.code.sf.net/p/mutilities/code MUtilities</code> (<a href="http://sourceforge.net/p/mutilities/code/">Browse</a>)</p></li> <li><p><code>git clone git://git.code.sf.net/p/mutilities/code MUtilities</code> (<a href="http://sourceforge.net/p/mutilities/code/">Browse</a>)</p></li>
<li><p><code>git clone https://github.com/lordmulder/MUtilities.git MUtilities</code> (<a href="https://github.com/lordmulder/MUtilities">Browse</a>)</p></li> <li><p><code>git clone https://github.com/lordmulder/MUtilities.git MUtilities</code> (<a href="https://github.com/lordmulder/MUtilities">Browse</a>)</p></li>
@ -431,7 +443,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.<
<li><p><code>git clone git://gitorious.org/mutilities/mutilities.git MUtilities</code> (<a href="http://gitorious.org/mutilities/mutilities/trees/master">Browse</a>)</p></li> <li><p><code>git clone git://gitorious.org/mutilities/mutilities.git MUtilities</code> (<a href="http://gitorious.org/mutilities/mutilities/trees/master">Browse</a>)</p></li>
<li><p><code>git clone git://repo.or.cz/MUtilities.git MUtilities</code> (<a href="http://repo.or.cz/w/MUtilities.git">Browse</a>)</p></li> <li><p><code>git clone git://repo.or.cz/MUtilities.git MUtilities</code> (<a href="http://repo.or.cz/w/MUtilities.git">Browse</a>)</p></li>
</ul> </ul>
<p> <br /><em>Remarks:</em> In case you are new to Git or want to extend your knowledge, have a look at the <a href="http://git-scm.com/book/en/v2"><em>Pro Git</em></a> book by Scott Chacon! For Windows users, we highly recommend using <a href="http://msysgit.github.com/"><em>MSYS Git</em></a> in conjunction with the superb <a href="http://tortoisegit.googlecode.com/"><em>Tortoise Git</em></a> front-end.</p> <p><em>Remarks:</em> In case you are new to Git or want to extend your knowledge, have a look at the <a href="http://git-scm.com/book/en/v2"><em>Pro Git</em></a> book by Scott Chacon! For Windows users, we highly recommend using <a href="http://msysgit.github.com/"><em>MSYS Git</em></a> in conjunction with the superb <a href="http://tortoisegit.googlecode.com/"><em>Tortoise Git</em></a> front-end.</p>
<h2 id="build-prerequisites"><span class="header-section-number">8.2</span> Build Prerequisites</h2> <h2 id="build-prerequisites"><span class="header-section-number">8.2</span> Build Prerequisites</h2>
<p>LameXP is currently being developed and built using the following development tools and libraries:</p> <p>LameXP is currently being developed and built using the following development tools and libraries:</p>
<ul> <ul>
@ -440,7 +452,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.<
<li><p>Windows Platform SDK v7.1A, included with Visual Studio 2013 or Visual Studio 2012</p></li> <li><p>Windows Platform SDK v7.1A, included with Visual Studio 2013 or Visual Studio 2012</p></li>
<li><p>The minimum supported <em>build</em> platform is Windows 7 (x86 and x64)</p></li> <li><p>The minimum supported <em>build</em> platform is Windows 7 (x86 and x64)</p></li>
</ul> </ul>
<p> <br />In order to create LameXP release packages, using the included deployment scripts, you need the following additional tools:</p> <p>In order to create LameXP release packages, using the included deployment scripts, you need the following additional tools:</p>
<ul> <ul>
<li><p><a href="http://www.7-zip.org/">7-Zip</a> – file archiver with a high compression ratio</p></li> <li><p><a href="http://www.7-zip.org/">7-Zip</a> – file archiver with a high compression ratio</p></li>
<li><p><a href="http://nsis.sourceforge.net/">NSIS</a> – Nullsoft Scriptable Install System (<a href="http://www.scratchpaper.com/"><em>Unicode version</em></a> recommended!)</p> <li><p><a href="http://nsis.sourceforge.net/">NSIS</a> – Nullsoft Scriptable Install System (<a href="http://www.scratchpaper.com/"><em>Unicode version</em></a> recommended!)</p>
@ -492,7 +504,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.<
<li><p>ImageFormat plugins go to <code>Prerequisites\qt4_static\plugins\imageformats</code></p></li> <li><p>ImageFormat plugins go to <code>Prerequisites\qt4_static\plugins\imageformats</code></p></li>
<li><p>Congratulations, you should now be prepared to build the <code>Release_Static</code> configuration of LameXP 😊</p></li> <li><p>Congratulations, you should now be prepared to build the <code>Release_Static</code> configuration of LameXP 😊</p></li>
</ol> </ol>
<p> <br /><em>Note:</em> Static libraries only work with the exactly same compiler (version) they were built with!</p> <p><em>Note:</em> Static libraries only work with the exactly same compiler (version) they were built with!</p>
<h1 id="f.a.q.-frequently-asked-questions"><span class="header-section-number">9</span> F.A.Q. (Frequently Asked Questions)</h1> <h1 id="f.a.q.-frequently-asked-questions"><span class="header-section-number">9</span> F.A.Q. (Frequently Asked Questions)</h1>
<p>This section tries to answer some of the most frequently asked questions. So if you have a question, please have a look at this section, before you send the question to us 😉</p> <p>This section tries to answer some of the most frequently asked questions. So if you have a question, please have a look at this section, before you send the question to us 😉</p>
<h2 id="q-do-i-have-to-pay-for-using-or-obtaining-lamexp"><span class="header-section-number">9.1</span> Q: Do I have to pay for using or obtaining LameXP?</h2> <h2 id="q-do-i-have-to-pay-for-using-or-obtaining-lamexp"><span class="header-section-number">9.1</span> Q: Do I have to pay for using or obtaining LameXP?</h2>

43
doc/Manual.md
View File

@ -1,4 +1,5 @@
% LameXP Audio-Encoder Front-End &ndash; Manual % LameXP Audio-Encoder Front-End &ndash; Manual
% Created by LoRd_MuldeR &lt;<mulder2@gmx>&gt; &ndash; check <http://muldersoft.com/> for news and updates!
# Introduction # # Introduction #
@ -38,7 +39,6 @@ The following *legacy* platforms are **not** actively supported any longer:
* Microsoft Windows 98 * Microsoft Windows 98
* Microsoft Windows 95 * Microsoft Windows 95
&nbsp;
*Remarks:* Windows XP has reached "end of life" on April 8th, 2014. This means that Microsoft has stopped all support for Windows XP. Thus **no** updates or bugfixes are made available to regular Windows XP users since that date, **not** even security fixes! Thus, all the security vulnerabilities that have been discovered *after* the deadline &ndash; and all the security vulnerabilities that are going to be discovered in the future &ndash; will *persists* forever! Consequently, using Windows XP has become a severe security risk, and the situation is only going to get worse. While LameXP will continue to support Windows XP (note that Service Pack 3 is required!) for the foreseeable future, we *highly* recommend everybody to update to a less antiquated system now. Windows XP support will be discontinued in a future version, when most users have migrated to a contemporary system. *Remarks:* Windows XP has reached "end of life" on April 8th, 2014. This means that Microsoft has stopped all support for Windows XP. Thus **no** updates or bugfixes are made available to regular Windows XP users since that date, **not** even security fixes! Thus, all the security vulnerabilities that have been discovered *after* the deadline &ndash; and all the security vulnerabilities that are going to be discovered in the future &ndash; will *persists* forever! Consequently, using Windows XP has become a severe security risk, and the situation is only going to get worse. While LameXP will continue to support Windows XP (note that Service Pack 3 is required!) for the foreseeable future, we *highly* recommend everybody to update to a less antiquated system now. Windows XP support will be discontinued in a future version, when most users have migrated to a contemporary system.
@ -118,7 +118,6 @@ LameXP is [*free software*](http://en.wikipedia.org/wiki/Free_software_movement)
along with this program; if not, write to the Free Software along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
&nbsp;
**Addendum:** When distributing binaries of the LameXP software, it is *strictly forbidden* to bundle the LameXP program files and/or the LameXP installation program with any kind of *Adware*, *Spyware* or *PUP (potentially unwanted program)*, including, but not limited to, any downloaders, dialers, browser toolbars/extensions or restricted shareware/demo programs. It is, however, perfectly legitimate to bundle LameXP with other *OpenSource* programs, according to the OSI (Open Source Initiative). Finally, it is also legitimate to bundle LameXP with *commercial software*, as long as that software does *not* meet the criteria of *Adware*, *Spyware* or *PUP*. If you bundle the LameXP software with another software, you are *required* to make sure that the user is provided with an easy way to install and start the LameXP software separately from that other software. **Addendum:** When distributing binaries of the LameXP software, it is *strictly forbidden* to bundle the LameXP program files and/or the LameXP installation program with any kind of *Adware*, *Spyware* or *PUP (potentially unwanted program)*, including, but not limited to, any downloaders, dialers, browser toolbars/extensions or restricted shareware/demo programs. It is, however, perfectly legitimate to bundle LameXP with other *OpenSource* programs, according to the OSI (Open Source Initiative). Finally, it is also legitimate to bundle LameXP with *commercial software*, as long as that software does *not* meet the criteria of *Adware*, *Spyware* or *PUP*. If you bundle the LameXP software with another software, you are *required* to make sure that the user is provided with an easy way to install and start the LameXP software separately from that other software.
@ -182,14 +181,12 @@ Shortly after launching the setup program, an [UAC](http://en.wikipedia.org/wiki
![Figure](img/lamexp/setup_1a.png) ![Figure](img/lamexp/setup_1a.png)
&nbsp;
Now simply follow the instructions of the setup wizard, which will guide you through the installation process&hellip; Now simply follow the instructions of the setup wizard, which will guide you through the installation process&hellip;
*Note:* Please do **not** change the "Destionation Folder", unless you know exactly what you are doing. The "Destionation Folder" cannot be changed, when *upgrading* an existing LameXP installation. *Note:* Please do **not** change the "Destionation Folder", unless you know exactly what you are doing. The "Destionation Folder" cannot be changed, when *upgrading* an existing LameXP installation.
![Figure](img/lamexp/setup_1b.png) ![Figure](img/lamexp/setup_1b.png)
&nbsp;
Congratulation, LameXP has been installed successfully on your computer! Congratulation, LameXP has been installed successfully on your computer!
*Note:* If you keep the "Run LameXP &hellip;" option enabled and click on the "Finish" button, the LameXP software will be launched immediately. *Note:* If you keep the "Run LameXP &hellip;" option enabled and click on the "Finish" button, the LameXP software will be launched immediately.
@ -203,14 +200,12 @@ If you decided for the **ZIP package**, you need to open the downloaded ZIP file
![Figure](img/lamexp/setup_2a.png) ![Figure](img/lamexp/setup_2a.png)
&nbsp;
This step may be slightly different, depending on what file archive software (e.g. 7-Zip or WinRAR) you are using. Select **all** files in the LameXP ZIP archive and *extract* them to a new/empty directory of your choice. This step may be slightly different, depending on what file archive software (e.g. 7-Zip or WinRAR) you are using. Select **all** files in the LameXP ZIP archive and *extract* them to a new/empty directory of your choice.
*Note:* It is very important that you have write-access to the chosen destination directory. So make sure that you choose a directory where the required access rights are granted! *Note:* It is very important that you have write-access to the chosen destination directory. So make sure that you choose a directory where the required access rights are granted!
![Figure](img/lamexp/setup_2b.png) ![Figure](img/lamexp/setup_2b.png)
&nbsp;
Congratulation, LameXP has been installed successfully on your computer! Now double-click on the ``LameXP.exe`` program file in order to launch the application! Congratulation, LameXP has been installed successfully on your computer! Now double-click on the ``LameXP.exe`` program file in order to launch the application!
![Figure](img/lamexp/setup_2c.png) ![Figure](img/lamexp/setup_2c.png)
@ -262,26 +257,22 @@ First of all, you need to download the Nero AAC encoder from the official Nero D
* <http://www.nero.com/eng/company/about-nero/nero-aac-codec.php> * <http://www.nero.com/eng/company/about-nero/nero-aac-codec.php>
* <http://www.free-codecs.com/download/Nero_AAC_Codec.htm> * <http://www.free-codecs.com/download/Nero_AAC_Codec.htm>
&nbsp;
Simply scroll down, click the "I agree" button, and enter ``user@example.com`` when asked for an e-mail address. Finally, click the "Download" button, which initates the download of the required ``NeroAACCodec-1.5.1.zip`` file. Simply scroll down, click the "I agree" button, and enter ``user@example.com`` when asked for an e-mail address. Finally, click the "Download" button, which initates the download of the required ``NeroAACCodec-1.5.1.zip`` file.
*Note:* Although the ZIP file is called ``NeroAACCodec-1.5.1.zip``, it actually contains version **1.5.4.0** of the Nero AAC encoder software. Please check the included ``changelog.txt`` to verify this! *Note:* Although the ZIP file is called ``NeroAACCodec-1.5.1.zip``, it actually contains version **1.5.4.0** of the Nero AAC encoder software. Please check the included ``changelog.txt`` to verify this!
![Figure](img/lamexp/setup_4a.png) ![Figure](img/lamexp/setup_4a.png)
&nbsp;
Now open the downloaded ZIP file 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 navigate to the "win32" sub-directory. Now open the downloaded ZIP file 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 navigate to the "win32" sub-directory.
![Figure](img/lamexp/setup_4b.png) ![Figure](img/lamexp/setup_4b.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. the ``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. *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_4c.png) ![Figure](img/lamexp/setup_4c.png)
&nbsp;
Once the required Nero AAC files have been put into the proper place, simply *restart* LameXP in order to enable the AAC encoding support! Once the required Nero AAC files have been put into the proper place, simply *restart* LameXP in order to enable the AAC encoding support!
@ -297,14 +288,12 @@ First of all, you need to download the [QAAC](https://github.com/nu774/qaac) app
* <http://sourceforge.net/projects/lamexp/files/Miscellaneous/Add-ins/qaac/> * <http://sourceforge.net/projects/lamexp/files/Miscellaneous/Add-ins/qaac/>
* <http://muldersoft.com/misc/lamexp/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. 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. Make sure your files are up-to-date! *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. Make sure your files are up-to-date!
![Figure](img/lamexp/setup_5a.png) ![Figure](img/lamexp/setup_5a.png)
&nbsp;
Please *extract* all the three files, the program ``qaac.exe`` plus its companion 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. Please *extract* all the three files, the program ``qaac.exe`` plus its companion 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. *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.
@ -321,19 +310,16 @@ The required "Apple Application Support" package is included, for example, in th
* <https://www.apple.com/quicktime/download/> * <https://www.apple.com/quicktime/download/>
* <https://www.apple.com/itunes/download/> * <https://www.apple.com/itunes/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! 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. 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_5c.png) ![Figure](img/lamexp/setup_5c.png)
&nbsp;
After the "Apple Application Support" setup package has been extracted, you can launch it by double-clicking on the ``AppleApplicationSupport.msi`` file. Then simply follow the installer's instructions. After the "Apple Application Support" setup package has been extracted, you can launch it by double-clicking on the ``AppleApplicationSupport.msi`` file. Then simply follow the installer's instructions.
![Figure](img/lamexp/setup_5d.png) ![Figure](img/lamexp/setup_5d.png)
&nbsp;
Once the QAAC encoder as well as the Apple AAC encoder libraries ("Apple Application Support") have been installed properly, simply *restart* LameXP in order to enable the AAC encoding support! Once the QAAC encoder as well as the Apple AAC encoder libraries ("Apple Application Support") have been installed properly, simply *restart* LameXP in order to enable the AAC encoding support!
*Note:* You may run ``qaac.exe --check`` from the [command prompt](http://en.wikipedia.org/wiki/Cmd.exe) to ensure that QAAC has been set up correctly. Expected output is ``qaac 2.xx, CoreAudioToolbox x.x.x.x``. *Note:* You may run ``qaac.exe --check`` from the [command prompt](http://en.wikipedia.org/wiki/Cmd.exe) to ensure that QAAC has been set up correctly. Expected output is ``qaac 2.xx, CoreAudioToolbox x.x.x.x``.
@ -351,17 +337,18 @@ First of all, you need to add all **source files** that you want to convert. So
![Figure](img/lamexp/tutorial_1a.png) ![Figure](img/lamexp/tutorial_1a.png)
&nbsp;
This will bring up a standard file selection dialogue. Now simply select the files that you want to add and click the "Open" button. You can repeat this step multiple times, e.g. to add files from different directories. This will bring up a standard file selection dialogue. Now simply select the files that you want to add and click the "Open" button. You can repeat this step multiple times, e.g. to add files from different directories.
![Figure](img/lamexp/tutorial_1b.png) ![Figure](img/lamexp/tutorial_1b.png)
&nbsp; All files you have added, so far, will show up in the list. You can click the "Remove" button to remove a single file from the list or "Clear" to remove them all. You can also click the "Show details" button to show details about the selected file.
All files you have added, so far, will show up in the list. You can click the "Remove" button to remove a single file from the list or "Clear" to remove them all. Click the "Show details" button to show details about a file.
![Figure](img/lamexp/tutorial_1c.png) ![Figure](img/lamexp/tutorial_1c.png)
&nbsp; If you want to add an *entire* directory, you can select "Open Folder" from the "File" menu, which will bring up a directory selection dialogue. "Open Folder Recursively" works in a similar way, but also includes *all* sub-directories.
![Figure](img/lamexp/tutorial_1d.png)
*Did you know?* Files can also be added via [Drag &amp; Drop](http://en.wikipedia.org/wiki/Drag_and_drop). Just grab the files that you want to add in your Explorer window and drop them onto the LameXP main window (or onto the LameXP "dropbox" widget). *Did you know?* Files can also be added via [Drag &amp; Drop](http://en.wikipedia.org/wiki/Drag_and_drop). Just grab the files that you want to add in your Explorer window and drop them onto the LameXP main window (or onto the LameXP "dropbox" widget).
@ -373,17 +360,14 @@ Next, you need to choose the **output directory**, i.e. the directory where the
![Figure](img/lamexp/tutorial_2a.png) ![Figure](img/lamexp/tutorial_2a.png)
&nbsp;
Sometimes you may wish to store the converted files in a *new* (sub-)folder. In this case, simply click the "Make New Folder" button, enter the desired folder name and hit the "OK" button. Sometimes you may wish to store the converted files in a *new* (sub-)folder. In this case, simply click the "Make New Folder" button, enter the desired folder name and hit the "OK" button.
![Figure](img/lamexp/tutorial_2b.png) ![Figure](img/lamexp/tutorial_2b.png)
&nbsp;
The new folder is going to be created inside the current directory and will be selected automatically. You can repeat this step multiple times in order to created nested sub-folders. The new folder is going to be created inside the current directory and will be selected automatically. You can repeat this step multiple times in order to created nested sub-folders.
![Figure](img/lamexp/tutorial_2c.png) ![Figure](img/lamexp/tutorial_2c.png)
&nbsp;
*Did you know?* If you enable the "Save output files in the same directory where the input file is located" option, each output file will be saved to the same location where the corresponding source file resides. *Did you know?* If you enable the "Save output files in the same directory where the input file is located" option, each output file will be saved to the same location where the corresponding source file resides.
@ -395,21 +379,18 @@ Finally, you need to choose your **compression settings**. First, and most impor
![Figure](img/lamexp/tutorial_3a.png) ![Figure](img/lamexp/tutorial_3a.png)
&nbsp;
Once you have decided for an audio format, you need to choose a *rate-control* mode next. The available rate-control modes include VBR (quality-base variable bitrate), ABR (average bitrate) and CBR (constant bitrate). Not all modes are available for all audio formats. Once you have decided for an audio format, you need to choose a *rate-control* mode next. The available rate-control modes include VBR (quality-base variable bitrate), ABR (average bitrate) and CBR (constant bitrate). Not all modes are available for all audio formats.
*Note:* If you are uncertain which rate-control mode to chose, the guideline is that VBR mode should be preferred over ABR mode whenever possible. And CBR mode generally should be avoided. See also Wikipedia's article on [variable bitrate](http://en.wikipedia.org/wiki/Variable_bitrate) encoding. *Note:* If you are uncertain which rate-control mode to chose, the guideline is that VBR mode should be preferred over ABR mode whenever possible. And CBR mode generally should be avoided. See also Wikipedia's article on [variable bitrate](http://en.wikipedia.org/wiki/Variable_bitrate) encoding.
![Figure](img/lamexp/tutorial_3b.png) ![Figure](img/lamexp/tutorial_3b.png)
&nbsp;
Last but not least, you need to choose the desired target *bitrate* or *quality-level*. Put simply, this controls the "quality vs. file size" trade-off. You choose a target quality-level in case of VBR mode, and you choose a target (average) bitrate in case of ABR or CBR mode. Last but not least, you need to choose the desired target *bitrate* or *quality-level*. Put simply, this controls the "quality vs. file size" trade-off. You choose a target quality-level in case of VBR mode, and you choose a target (average) bitrate in case of ABR or CBR mode.
*Note:* If you are uncertain which bitrate or quality-level to choose, bare in mind that a higher bitrate (or a better quality level) results in better audio quality, but also produces larger files &ndash; and vice versa. "Level 2" or "192 kbps" is a typical choice for MP3. *Note:* If you are uncertain which bitrate or quality-level to choose, bare in mind that a higher bitrate (or a better quality level) results in better audio quality, but also produces larger files &ndash; and vice versa. "Level 2" or "192 kbps" is a typical choice for MP3.
![Figure](img/lamexp/tutorial_3c.png) ![Figure](img/lamexp/tutorial_3c.png)
&nbsp;
*Did you know?* You can click on the "Reset" link at any time in order to reset all available settings for all available encoders to their factory defaults. *Did you know?* You can click on the "Reset" link at any time in order to reset all available settings for all available encoders to their factory defaults.
@ -419,19 +400,16 @@ When everything has been set up properly, the time has come to actually start th
![Figure](img/lamexp/tutorial_4a.png) ![Figure](img/lamexp/tutorial_4a.png)
&nbsp;
This will bring up the "Processing" dialogue. LameXP will now convert all your audio files on the list. Depending on the number of audio files and depending on the performance of your system, this may take several minutes, so please be patient &#x1f609; This will bring up the "Processing" dialogue. LameXP will now convert all your audio files on the list. Depending on the number of audio files and depending on the performance of your system, this may take several minutes, so please be patient &#x1f609;
*Note:* In order to leverage the power "multi-core" processors and thus massively speed-up the encoding process, LameXP will run multiple encoding jobs in parallel &ndash; provided that your system has multiple processor cores and that there are enough encoding jobs left in the queue. *Note:* In order to leverage the power "multi-core" processors and thus massively speed-up the encoding process, LameXP will run multiple encoding jobs in parallel &ndash; provided that your system has multiple processor cores and that there are enough encoding jobs left in the queue.
![Figure](img/lamexp/tutorial_4b.png) ![Figure](img/lamexp/tutorial_4b.png)
&nbsp;
The "Processing" dialogue is going to turn *green*, as soon as all encoding jobs have finished successfully. If anything went wrong, e.g. if one of the encoding jobs failed for some reason, it will turn *red* instead. The "Processing" dialogue is going to turn *green*, as soon as all encoding jobs have finished successfully. If anything went wrong, e.g. if one of the encoding jobs failed for some reason, it will turn *red* instead.
![Figure](img/lamexp/tutorial_4c.png) ![Figure](img/lamexp/tutorial_4c.png)
&nbsp;
*Did you know?* You can double-click on a completed (or failed) job in the list, in order to bring up a dialogue with all details about the specific job. This is especially useful, if something went wrong. *Did you know?* You can double-click on a completed (or failed) job in the list, in order to bring up a dialogue with all details about the specific job. This is especially useful, if something went wrong.
@ -538,7 +516,6 @@ The latest *official* release of the LameXP software can be obtained from one of
* <http://www.free-codecs.com/lamexp_download.htm> * <http://www.free-codecs.com/lamexp_download.htm>
* <http://www.videohelp.com/tools/LameXP> * <http://www.videohelp.com/tools/LameXP>
&nbsp;
It is *highly recommended* to download LameXP *only* from one of the official mirrors listed above. We are **not** responsible for the integrity and trustworthiness of LameXP downloads you may have received from other locations! It is *highly recommended* to download LameXP *only* from one of the official mirrors listed above. We are **not** responsible for the integrity and trustworthiness of LameXP downloads you may have received from other locations!
@ -554,7 +531,6 @@ If you want to report any problems that you have encountered with the LameXP sof
* In any case, the [environment variable](http://en.wikipedia.org/wiki/Environment_variable) ``MUTILS_LOGFILE`` may be used to specify a *log file* that will be created by LameXP. The information saved to the log file are the same as those available from the debug console. * In any case, the [environment variable](http://en.wikipedia.org/wiki/Environment_variable) ``MUTILS_LOGFILE`` may be used to specify a *log file* that will be created by LameXP. The information saved to the log file are the same as those available from the debug console.
&nbsp;
*Note:* We highly recommend using a web-service like [Gist](https://gist.github.com/), [Pastie](http://pastie.org/) or [Pastebin](http://pastebin.com/) in order to share your diagnostic information. Please avoid posting long log files directly on the forums! *Note:* We highly recommend using a web-service like [Gist](https://gist.github.com/), [Pastie](http://pastie.org/) or [Pastebin](http://pastebin.com/) in order to share your diagnostic information. Please avoid posting long log files directly on the forums!
@ -564,7 +540,6 @@ The recommended way to submit *bug reports* or *feature requests* to the LameXP
* <https://github.com/lordmulder/LameXP/issues> * <https://github.com/lordmulder/LameXP/issues>
&nbsp;
*Note:* In order to use the issue tracking system, you need to log in with your GitHub account. Creating a GitHub account is easy and completely free of charge, simply click [here](https://github.com/join)! *Note:* In order to use the issue tracking system, you need to log in with your GitHub account. Creating a GitHub account is easy and completely free of charge, simply click [here](https://github.com/join)!
@ -575,7 +550,6 @@ If you want to discuss the development of the LameXP software, help other users
* <http://forum.doom9.org/showthread.php?t=157726> &ndash; English * <http://forum.doom9.org/showthread.php?t=157726> &ndash; English
* <http://forum.gleitz.info/showthread.php?t=37956> &ndash; German * <http://forum.gleitz.info/showthread.php?t=37956> &ndash; German
&nbsp;
*Note:* Due to the massive amount of spam attacks, Doom9 has established strict anti-spam measures. Therefore, it takes a few days until your account will be approved. *Note:* Due to the massive amount of spam attacks, Doom9 has established strict anti-spam measures. Therefore, it takes a few days until your account will be approved.
@ -603,7 +577,6 @@ The source code of the **LameXP** software is managed using the [*Git*](http://g
* ``git clone git://repo.or.cz/LameXP.git LameXP`` ([Browse](http://repo.or.cz/w/LameXP.git)) * ``git clone git://repo.or.cz/LameXP.git LameXP`` ([Browse](http://repo.or.cz/w/LameXP.git))
&nbsp;
The source code of the **MUtilities** library is managed using the [*Git*](http://git-scm.com/) version control system. The Git repository can be *cloned* from one of the official Git mirrors: The source code of the **MUtilities** library is managed using the [*Git*](http://git-scm.com/) version control system. The Git repository can be *cloned* from one of the official Git mirrors:
* ``git clone git://git.code.sf.net/p/mutilities/code MUtilities`` ([Browse](http://sourceforge.net/p/mutilities/code/)) * ``git clone git://git.code.sf.net/p/mutilities/code MUtilities`` ([Browse](http://sourceforge.net/p/mutilities/code/))
@ -620,7 +593,6 @@ The source code of the **MUtilities** library is managed using the [*Git*](http:
* ``git clone git://repo.or.cz/MUtilities.git MUtilities`` ([Browse](http://repo.or.cz/w/MUtilities.git)) * ``git clone git://repo.or.cz/MUtilities.git MUtilities`` ([Browse](http://repo.or.cz/w/MUtilities.git))
&nbsp;
*Remarks:* In case you are new to Git or want to extend your knowledge, have a look at the [*Pro Git*](http://git-scm.com/book/en/v2) book by Scott Chacon! For Windows users, we highly recommend using [*MSYS Git*](http://msysgit.github.com/) in conjunction with the superb [*Tortoise Git*](http://tortoisegit.googlecode.com/) front-end. *Remarks:* In case you are new to Git or want to extend your knowledge, have a look at the [*Pro Git*](http://git-scm.com/book/en/v2) book by Scott Chacon! For Windows users, we highly recommend using [*MSYS Git*](http://msysgit.github.com/) in conjunction with the superb [*Tortoise Git*](http://tortoisegit.googlecode.com/) front-end.
@ -636,7 +608,6 @@ LameXP is currently being developed and built using the following development to
* The minimum supported *build* platform is Windows 7 (x86 and x64) * The minimum supported *build* platform is Windows 7 (x86 and x64)
&nbsp;
In order to create LameXP release packages, using the included deployment scripts, you need the following additional tools: In order to create LameXP release packages, using the included deployment scripts, you need the following additional tools:
* [7-Zip](http://www.7-zip.org/) &ndash; file archiver with a high compression ratio * [7-Zip](http://www.7-zip.org/) &ndash; file archiver with a high compression ratio
@ -704,7 +675,6 @@ In order to create a "fully static" build of LameXP, i.e. a build that does *not
15. Congratulations, you should now be prepared to build the ``Release_Static`` configuration of LameXP &#x1f60a; 15. Congratulations, you should now be prepared to build the ``Release_Static`` configuration of LameXP &#x1f60a;
&nbsp;
*Note:* Static libraries only work with the exactly same compiler (version) they were built with! *Note:* Static libraries only work with the exactly same compiler (version) they were built with!
@ -795,7 +765,6 @@ If you want to verify the LameXP signatures yourself, then you may do so by usin
*Note:* Before LameXP actually tries to download information from our update servers, it will check your internet connection first. Only checking whether the update server is reachable does **not** suffice here. In case that the update server does **not** respond, this could mean that our servers are currently experiencing problems, but it could also mean that your Internet connection is failing. In order to distinguish these cases, LameXP will validate the Internet connection prior to connecting to the update server. For this purpose, LameXP contains a rather long list of "known" hosts, taken mostly from [Alexa's Top 500](http://www.alexa.com/topsites) list. In order to validate the Internet connection, LameXP will pick a *random* host from the list and check whether that host can be reached. This process will be repeated, until a certain minimum number of "known" hosts have been reached successfully. *Note:* Before LameXP actually tries to download information from our update servers, it will check your internet connection first. Only checking whether the update server is reachable does **not** suffice here. In case that the update server does **not** respond, this could mean that our servers are currently experiencing problems, but it could also mean that your Internet connection is failing. In order to distinguish these cases, LameXP will validate the Internet connection prior to connecting to the update server. For this purpose, LameXP contains a rather long list of "known" hosts, taken mostly from [Alexa's Top 500](http://www.alexa.com/topsites) list. In order to validate the Internet connection, LameXP will pick a *random* host from the list and check whether that host can be reached. This process will be repeated, until a certain minimum number of "known" hosts have been reached successfully.
&nbsp; &nbsp;
&nbsp; &nbsp;
**EOF** **EOF**

BIN
doc/img/lamexp/tutorial_1d.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 54 KiB

7
etc/Style/style.css
View File

@ -3,12 +3,15 @@
body { font-family: "Times New Roman", Times, serif; color: #000000; background-color: #FFFFFF; } body { font-family: "Times New Roman", Times, serif; color: #000000; background-color: #FFFFFF; }
p { text-align: justify; } p { text-align: justify; }
tt, pre, code { font-family: Courier New, Courier, mono; background-color: #EDF3F7; padding: 1px; } tt, pre, code { font-family: Courier New, Courier, mono; background-color: #EDF3F7; padding: 1px; }
h1:not(:first-child) { margin-top: 2.25em; } h1:not(.title) { margin-top: 2.25em; }
h2 { margin-top: 2.0em; } h2:not(.author) { margin-top: 2.0em; }
h3, h4 { margin-top: 1.75em; } h3, h4 { margin-top: 1.75em; }
a { color: #0000BB; text-decoration: none; } a { color: #0000BB; text-decoration: none; }
a:visited { color: #0000BB; text-decoration: none; } a:visited { color: #0000BB; text-decoration: none; }
a:active { color: #0000FF; text-decoration: none; } a:active { color: #0000FF; text-decoration: none; }
a:hover { color: #0000FF; text-decoration: underline; } a:hover { color: #0000FF; text-decoration: underline; }
img { margin-bottom: 0.75em; }
ul, ol { margin-bottom: 2.0em; }
li>ul, li>ol { margin-bottom: 0em; }
--> -->
</style> </style>