Fixed a typo.
[LameXP.git] / doc / FAQ.html
blob4102b25d27e6e394a04a4ef8a6b487326b3c5dfe
1 <html>
2 <head><title>LameXP - Frequently Asked Questions (FAQ)</title></head>
3 <body><tt>
4 <h3>LameXP - Frequently Asked Questions (FAQ)</h3><br>
6 <b>What is LameXP ???</b><br>
7 <br>
8 LameXP is a graphical user-interface for a number of audio encoders. It was developed to support a huge<br>
9 number of input formats. File formats are detected reliably using MediaInfo. Compressed audio formats are<br>
10 decoded to uncompressed Wave files using suitable CLI audio decoders. Furthermore LameXP allows batch<br>
11 processing of multiple audio files. Multithreading is implemented by processing several audio files<br>
12 concurrently. All the third-party tools incorporated in LameXP are listed in the "About" dialog. The Nero AAC<br>
13 encoder cannot be redistribited due to licensing issues; it is availabel as a free download from the public<br>
14 Nero web-site. Note: LameXP does NOT use/need any "external" audio decoders. It neither requires nor supports<br>
15 any ACM Codecs or DirectShow/DMO filters! And it will NOT install anything of that kind on your system.<br><br>
17 <br><br>
19 <b>What platforms does LameXP run on?</b><br>
20 <br>
21 LameXP is currently being develped and tested on the following platforms:<br><ul>
22 <li>Microsoft Windows XP, Service Pack 3
23 <li>Microsoft Windows 7, 32-Bit and 64-Bit editions
24 <li>Microsoft Windows 2000, Service Pack 4</ul>
25 <br>
26 The following platforms should work as well, but aren't tested extensively:<br><ul>
27 <li>Microsoft Windows Vista, 32-Bit and 64-Bit editions
28 <li>Microsoft Windows Server 2008
29 <li>Microsoft Windows Server 2008 R2
30 <li>GNU/Linux using Wine (native Linux version planned)</ul>
31 <br>
32 The following platforms are NOT supported any longer:<br><ul>
33 <li>Microsoft Windows 95
34 <li>Microsoft Windows 98
35 <li>Micorosft Windows Millenium Edition</ul>
37 <br><br>
39 <b>What output formats (encoders) does LameXP support?</b><br>
40 <br>
41 Currently the follwing output formats are supported by LameXP:<br><ul>
42 <li>MPEG Audio-Layer III (MP3), using the LAME encoder [built-in]
43 <li>Ogg Vorbis, using the OggEnc2/libvorbis encoder [built-in]
44 <li>Advanced Audio Coding (AAC), using Nero AAC encoder [available as separate download]
45 <li>Free Lossless Audio Codec (FLAC) [built-in]
46 <li>Uncompressed PCM / Waveform Audio File (WAV/RIFF)</ul>
48 <br><br>
50 <b>What input formats (decoders) does LameXP support?</b><br>
51 <br>
52 Currently the follwing input formats are supported by LameXP:<br><ul>
53 <li>AC-3 (ATSC A/52), using Valib decoder [built-in]
54 <li>Advanced Audio Coding (AAC), using FAAD decoder [built-in]
55 <li>Apple Lossless (ALAC)
56 <li>Apple/SGI AIFF
57 <li>Digital Theater System, using Valib decoder [built-in]
58 <li>Free Lossless Audio Codec (FLAC)
59 <li>Microsoft ADPCM
60 <li>Monkey's Audio (APE)
61 <li>MPEG Audio-Layer I (MP1), using mpg123 decoder [built-in]
62 <li>MPEG Audio-Layer II (MP2), using mpg123 decoder [built-in]
63 <li>MPEG Audio-Layer III (MP3), using mpg123 decoder [built-in]
64 <li>Musepack
65 <li>Shorten
66 <li>Speex
67 <li>Sun/NeXT Au
68 <li>The True Audio (TTA)
69 <li>Uncompressed PCM / Waveform Audio File (WAV/RIFF)
70 <li>WavPack Hybrid Lossless Audio
71 <li>Windows Media Audio (WMA), using NCH Software decoder [available as separate download]</ul>
73 <br><br>
75 <b>My anti-virus program raises an alarm when I try to download/install/launch LameXP. Why is that?</b><br>
76 <br>
77 Occasionally your anti-virus program may mistakenly detect "malware" (virus, trojan, worm, etc.) in some of<br>
78 the files here. This is called a "false-positive" and the files are actually innocent/clean. It's an error in<br>
79 your specific anti-virus software. In case you encounter such problems, goto <a href="http://www.virustotal.com/" target="_blank">http://www.virustotal.com/</a> and<br>
80 check the file with multiple anti-virus engines! Moreover take care with results like "suspicious", "generic"<br>
81 or "packed". Those are *not* real malware detections, they are just wild speculation.<br>
82 <br>
83 Apparently anti-virus programs tend to suspect installers/uninstaller created with NSIS. Furthermore some<br>
84 anti-virus programs blindly suspect all UPX'd (packed) executables of being malware. Obviously this is a<br>
85 stupid generalization, so please ignore those warnings! Last but not least: Always keep in mind that this is<br>
86 OpenSource software. If you don't trust the people providing the pre-compiled binaries, download the source<br>
87 code, search the code for "malicious" functions (good luck ^^) and compile your own binary.<br>
88 <br>
89 DON'T SUBMIT ANY VIRUS REPORTS, UNLESS YOU HAVE VERIFIED THE INFECTION WITH MULTIPLE ANTI-VIRUS ENGNINES!<br><br>
91 <br><br>
93 <b>Who created LameXP?</b><br>
94 <br>
95 LameXP was written from the scratch by LoRd_MuldeR &lt;MuldeR2@GMX.de&gt;. However it has to be noted that LameXP<br>
96 uses a number of thrird-party tools, which have been created by the individual authors. Moreover various<br>
97 people have contributed LameXP translations. Please see the "About" dialog for details!<br><br>
99 <br><br>
101 <b>What license is LameXP released under?</b><br>
102 <br>
103 LameXP is free software. You can redistribute it and/or modify it under the terms of the GNU General Public<br>
104 License (GPL) as published by the Free Software Foundation; either version 2 of the License, or (at your<br>
105 option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY<br>
106 WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.<br>
107 <br>
108 Please see the <a href="http://www.gnu.org/licenses/gpl-2.0.html" target="_blank">GNU General Public License</a> for more details!<br><br>
110 <br><br>
112 <b>Do I have to pay for LameXP? / How can I donate to the authors of LameXP?</b><br>
113 <br>
114 LameXP is <a href="http://en.wikipedia.org/wiki/Free_software" target="_blank">free software</a>, so you may use it for free and for any purpose. Moreover the authors of LameXP<br>
115 currently do NOT accept any donations. Therefore you should NOT pay or donate any money in order to obtain<br>
116 LameXP! However it was brought to our attention that some dubious thrid-party web-sites offer "payed"<br>
117 downloads of LameXP and/or include Adware into the LameXP download. We do NOT cooperate with any of these<br>
118 sites. So if you pay for the LameXP download, the authors of LameXP will not get a single cent! Instead you<br>
119 should save your money download LameXP from one of the "official" mirrors (see below), which is 100% free.<br>
120 <br>
121 If you want to support the development of LameXP, you can do so by contributing translations and/or code :-)<br><br>
123 <br><br>
125 <b>How do I enable AAC/MP4/M4A output (encoding) in LameXP?</b><br>
126 <br>
127 LameXP uses the Nero AAC Encoder for creating AAC/MP4/M4A files. The Nero AAC Encoder is available as a free<br>
128 download. However the license doesn't allow redistribution! Therefore we can NOT ship the Nero encoder along<br>
129 with LameXP. Instead you will have to obtain the Nero encoder as a separate download from the official "Nero<br>
130 Digital" web-site. Currently you'll find the latest Nero AAC Encoder version at this location:<br><ul>
131 <li><a href="http://www.nero.com/deu/downloads-nerodigital-nero-aac-codec.php" target="_blank">http://www.nero.com/deu/downloads-nerodigital-nero-aac-codec.php</a></ul>
132 <br>
133 After you have downloaded the Nero AAC Encoder as a ZIP file, you must "install" the encoder binaires, so<br>
134 LameXP can use them. Simply unzip the files 'neroAacEnc.exe', 'neroAacDec.exe' as well as 'neroAacTag.exe' to<br>
135 the same directory where your LameXP executable ('LameXP.exe') is located. For unzipping the ZIP file you can<br>
136 use any suitable archiver, such as <a href="http://rarlabs.com/download.htm" target="_blank">WinRAR</a> or <a href="http://sevenzip.sourceforge.net/" target="_blank">7-Zip</a>. Once the required Nero encoder binaries are located in<br>
137 the LameXP directory, the AAC encoding option should be "enabled" on the next startup of LameXP.<br><br>
139 <br><br>
141 <b>Is there a way to output ".aac" or ".m4a" files with LameXP?</b><br>
142 <br>
143 LameXP uses the Nero AAC Encoder for AAC encoding. And the Nero encoder always puts the AAC streams into an<br>
144 MP4 (MPEG-4 Part 14) container - in almost any case that is exactly what you want/need! The one and only<br>
145 "correct" file extension for MP4 files is '.mp4'. However sometimes the "incorrect" file extension '.m4a' is<br>
146 used to indicate "audio-only" MP4 files. Even worse: There are some buggy (hardware) players that will<br>
147 recognize MP4 audio file only with the "incorrect" .m4a extension, but NOT with the "correct" .mp4 extension.<br>
148 Of course LameXP will save your MP4 files with the "correct" .mp4 extension. But if you need your MP4 files<br>
149 with an .m4a extension for some reason, you can simply rename(!) these files. This isn't more or less<br>
150 "incorrect" than saving the files with an .m4a directly. After all, an MP4 file remains an MP4 file.<br>
151 <br>
152 Having said that, you should NOT rename any .mp4 or .m4a files to .aac, because these are MP4 files and NOT<br>
153 "raw" AAC streams. The Nero AAC encoder has NO option to output "raw" AAC streams and usually you don't need<br>
154 such streams. Still, if you want to extract the "raw" AAC stream from an MP4 file you can use <a href="http://www.videohelp.com/tools/mp4box" target="_blank">MP4Box</a>.<br><br>
156 <br><br>
158 <b>How do I enable WMA input (decoding) in LameXP?</b><br>
159 <br>
160 WMA input requires the WMA decoder component to be installed on your local computer. Usually LameXP will show<br>
161 a warning on startup, if the WMA decoder component could not be found. In that case you can simply choose<br>
162 "Download &amp; Install" in order to install the WMA decoder component on your system. Alternatively you can<br>
163 also install the WMA decoder component manually by choosing "Install WMA Decoder" from the "Tools" menu. In<br>
164 any case you must restart LameXP after the WMA decoder component has been installed.<br>
165 <br>
166 It has to be noted that the WMA decoder component relies on the Windows Media Format Runtime. All supported<br>
167 versions of Microsoft Windows should have the Windows Media Format Runtime installed out of the box. However<br>
168 Wine does not! In case you encounter problems with the WMA decoder component, try downloading and installing<br>
169 the <a href="http://www.free-codecs.com/download/Windows_Media_Format_11.htm" target="_blank">Windows Media Format 11 Runtime</a> manually. This should also work under Linux/Wine.<br><br>
171 <br><br>
173 <b>How can I use LameXP as a "portable" application?</b><br>
174 <br>
175 LameXP always is "portable", in the sense that the application works out of the box: LameXP does NOT require<br>
176 any additional software, such as codecs, encoders, decoders or runtime libraries, and it will NOT install<br>
177 anything of that kind on your local computer! All the third-party tools used by LameXP are already built-in.<br>
178 There currently are two notable exceptions: The Nero AAC encoder and the WMA decoder cannot be redistributed<br>
179 along with LameXP for legal reasons. Therefore these tools have to be obtained as separate downloads.<br>
180 <br>
181 Having said that, LameXP stores its configuration file in the <a href="http://msdn.microsoft.com/en-us/library/dd378457(v=vs.85).aspx#FOLDERID_LocalAppData" target="_blank">%LOCALAPPDATA%</a> folder on the local computer.<br>
182 That's because on a modern multi-user operating this is the only "correct" folder to store user-specific<br>
183 configuration files. Also it's one of the few folders where an application is guaranteed to get write-access,<br>
184 even when the application was launched by a "normal" (non-admin) user and did not request elevated rights.<br>
185 Storing the configuration file in the "install" folder is antiquated and highly error-prone.<br>
186 <br>
187 Still some users may want to store the configuration file in the same folder as the LameXP execuatble file,<br>
188 e.g. when launching LameXP directly from their USB stick on different computers. For this purpose LameXP now<br>
189 offers a "true" portable mode. You can enable that mode simply by renaming the LameXP executable file to<br>
190 "LameXP-Portable.exe". But be aware: When running LameXP in the "portable" mode, the user(!) must ensure that<br>
191 write-access is granted to the directory where the LameXP exectable is located.<br><br>
193 <br><br>
195 <b>The LameXP startup (splash screen) takes very long on my system. What can I do?</b><br>
196 <br>
197 Starting up LameXP shouldn't take longer than approximately 10 seconds. However it was brought to our<br>
198 attention that badly optimized anti-virus software can slow down the startup procedure a lot! On our test<br>
199 system (Windows 7 running on an Intel Core2 Q6600 with 4 GB of RAM) starting up LameXP takes about 3 seconds<br>
200 without an anti-virus software and about 6 seconds with the "real-time protection" of Micorosft Security<br>
201 Essentials enabled. With other anti-virus software the startup was delayed up to 20 seconds and more!<br>
202 <br>
203 So if you think that LameXP is starting up too slow on your system, you should temporarily(!) disable or<br>
204 uninstall your current anti-virus program and try again. Usually it should be sufficient to disable only the<br>
205 "real-time protection", "file system protection" or "guard" feature of your anti-virus software. If it turns<br>
206 out that the startup is signficanntly(!) faster WITHOUT the anti-virus software, please report the problem to<br>
207 the developer of the anti-virus software. And, if they don't fix the problem, switch to a better product!<br><br>
209 <br><br>
211 <b>How can I translate LameXP to my language or improve an existing translation?</b><br>
212 <br>
213 Please see the guide for translators at:<br><ul>
214 <li><a href="http://mulder.brhack.net/public/doc/lamexp_translate.html" target="_blank">http://mulder.brhack.net/public/doc/lamexp_translate.html</a></ul>
216 <br><br>
219 <b>Where can I download the latest version of LameXP?</b><br>
220 <br>
221 The latest "official" release of LameXP can be found on the following mirrors:<br><ul>
222 <li><a href="https://github.com/lordmulder/LameXP/downloads" target="_blank">https://github.com/lordmulder/LameXP/downloads</a>
223 <li><a href="http://sourceforge.net/projects/lamexp/files/" target="_blank">http://sourceforge.net/projects/lamexp/files/</a>
224 <li><a href="http://code.google.com/p/mulder/downloads/list" target="_blank">http://code.google.com/p/mulder/downloads/list</a></ul>
226 <br><br>
228 <b>Where can I submit bug reports or feature requests?</b><br>
229 <br>
230 The preferred place to report bugs or request new features is the LameXP thread at Doom9's Forum:<br><ul>
231 <li><a href="http://forum.doom9.org/showthread.php?t=157726" target="_blank">http://forum.doom9.org/showthread.php?t=157726</a></ul>
233 <br><br>
235 <b>Where can I find the LameXP source code?</b><br>
236 <br>
237 LameXP is developed using the <a href="http://en.wikipedia.org/wiki/Git_(software)" target="_blank">Git</a> revision control system. The LameXP Git repository is mirrored at:<br><ul>
238 <li><a href="git://github.com/lordmulder/LameXP.git" target="_blank">git://github.com/lordmulder/LameXP.git</a>
239 <li><a href="git://lamexp.git.sourceforge.net/gitroot/lamexp/lamexp" target="_blank">git://lamexp.git.sourceforge.net/gitroot/lamexp/lamexp</a>
240 <li><a href="git://gitorious.org/lamexp/lamexp.git" target="_blank">git://gitorious.org/lamexp/lamexp.git</a></ul>
242 <br><br>
244 <b>What are the prerequisites to build LameXP from the sources?</b><br>
245 <br>
246 LameXP is currently being developed using the following build environment:<br><ul>
247 <li>Visual Studio 2008, Service Pack 1
248 <li>Qt libraries v4.7.1 for Windows (VS 2008)
249 <li>Microsoft Windows SDK v7.1</ul>
250 <br>
251 Also note the following hints:<br><ul>
252 <li>You must launch Visual Studio using "qtvars.bat vsstart" in order to enable the Qt tools
253 <li>The Microsoft Windows SDK v6.0A should work as well, with a few limitations
254 <li>In order to make a fully "static" build of LameXP, you need to compile Qt as static libraries
255 <li>Support for the GNU Toolchain (GCC/MinGW + Make) is planned for a future version</ul>
257 <br><br>
259 eof</tt></body></html>