diff --git a/doc/Manual.html b/doc/Manual.html index 85118148..74f054a8 100644 --- a/doc/Manual.html +++ b/doc/Manual.html @@ -38,23 +38,33 @@
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.
TODO
+TODO
+For legal reasons, the AAC (Advanced Audio Coding) encoder can not be included in the official LameXP distribution packages. Therefore, you need to download and install the AAC encoder manually.
+LameXP can use the Nero Digital AAC encoder as well as the Apple (iTunes/QucikTime) AAC encoder. This chapter describes how to set up these AAC encoder for use with LameXP.
+First of all, you need to download the Nero AAC encoder from the official Nero Digital web-site. The download is free of charge:
+ +
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!
Now open the downloaded ZIP file with your favourite file archive software (we recommend using 7-Zip or WinRar) and navigate to the "win32" sub-directory.
Finally, extract all the three files neroAacDec.exe
, neroAacEnc.exe
and neroAacTag.exe
into the LameXP installation directory. That is the directory where your LameXP executable file, i.e. LameXP.exe
, is located.
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.
Once the required Nero AAC files have been put into the proper place, simply restart LameXP in order to enable the AAC encoding support!
TODO
+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.
-First of all, you need to add all source files that you want to convert. So switch to the "Source Files" tab, just in case that tab is not active already, and then click the "Add File(s)" button.
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, e.g. to add files from different directories.
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.
Did you know? Files can also be added via Drag & 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).
Next, you need to choose the output directory, i.e. the directory where the converted files will be saved. Switch to the "Output Directory" tab and choose the desired output directory from the directory tree view.
Note: There are several quick navigation buttons below, which will allow you to jump quickly to your personal "Home" folder, "Desktop" folder and "Music" folder, respectively.
@@ -173,7 +208,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.<
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.
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.
Finally, you need to choose your compression settings. First, and most important, you must decide for an output audio format (encoder). Depending on your needs and preferences, you can choose between MP3, Ogg/Vorbis, Opus, AAC/MP4, FLAC and others.
Note: If you are uncertain which audio format to choose, then this article by Lifehacker is a good starting point. Also see the comparison of audio coding formats on Wikipedia. If still uncertain, just go with good old MP3 😉
@@ -184,7 +219,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.<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 – and vice versa. "Level 2" or "192 kbps" is a typical choice for MP3.
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.
When everything has been set up properly, the time has come to actually start the encoding process. So simply click the "Encode Now" button in order to get going!
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 😉
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.
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.
Before you report any problems that you may have encountered with the LameXP software, please make sure that the problem can be reproduced with the latest release version of LameXP!
-The latest official release of the LameXP software can be obtained from one of the following official download mirrors:
It is highly recommended to download LameXP only from one of the official mirrors listed above. We assume no responsibility for the integrity and trustworthiness of LameXP downloads you may have received from other locations!
The recommended way to submit bug reports or feature requests to the LameXP developers is using the issue tracking system at our GitHub project site:
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!
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 Doom9's Forum:
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.
While LameXP originally was written in Delphi/Pascal, the current version 4 series of the software has been re-written in the C++ programming language. LameXP v4 uses the Qt cross-platform application framework and provides full Unicode support. Furthermore, LameXP is tightly coupled with the MUtilities library, a vast collection of "utility" routines and classes to extend the Qt framework. Build files are currently provided for Microsoft Visual Studio only. Linux support is currently provided via Wine; a native Linux port of LameXP is planned for a future version.
-The source code of the LameXP software is managed using the Git version control system. The Git repository can be cloned from one of the official Git mirrors:
git clone git://git.code.sf.net/p/lamexp/code LameXP
(Browse)
git clone git://repo.or.cz/MUtilities.git MUtilities
(Browse)
Remarks: In case you are new to Git or want to extend your knowledge, have a look at the Pro Git book by Scott Chacon! For Windows users, we highly recommend using MSYS Git in conjunction with the superb Tortoise Git front-end.
LameXP is currently being developed and built using the following development tools and libraries:
Visual Studio 2013 Update-4, running on Windows 7 with Service Pack 1
Pandoc – the Universal Document Converter
GnuPG – the GNU Privacy Guard v1.4.x
In order to create a "fully static" build of LameXP, i.e. a build that does not depend on any "external" DLL files (except for the obligatory operating system DLL's that you cannot get around), you'll need to compile Qt as "static" libraries. The official Qt web-site does provide pre-compiled Qt libraries. However, they only provide DLL versions, they do not provide "static" libraries. Consequently, you need to build the required "static" Qt libraries yourself. The following simple instructions should make it easy to build Qt from the sources and as "static" libraries:
Make sure Visual Studio 2013 with Update-4 (or later) is installed
Congratulations, you should now be prepared to build the Release_Static
configuration of LameXP 😊
Note: Static libraries only work with the exactly same compiler (version) they were built with!
TODO
eof