Difference between revisions of "LAME"

From Hydrogenaudio Knowledgebase
Jump to: navigation, search
(VBR (variable bitrate) settings: Point to the one table rather than maintaining two separate ones)
(Merged "further reading" section into "see also" section; moved acknowledgements to Talk:LAME; moved version string detail to its own article; added LAME tag info)
Line 198: Line 198:
 
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=78114 Lame 3.98 wastes bits]
 
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=78114 Lame 3.98 wastes bits]
  
===LAME version string formatting===
+
===VBR header and LAME tag===
The 9-character LAME short version string, as written in the [[MP3#VBRI, XING, and LAME headers|LAME tag]], has the following format:
+
:"<code>LAME</code>" + major version + "<code>.</code>" + minor version + flag
+
  
When the minor version is > 99, as is expected to happen when LAME 3.100 is released, the "<code>.</code>" will be omitted:
+
LAME supports the ''de facto'' standard of adding an extra frame of silence to the beginning of MP3 files. This "VBR header" or "Info tag" provides a home for precise info about the audio duration and a table of seek points. It is mainly for the benefit of players working with VBR files. Decoders usually treat the frame as informational, rather than playing the audio.
:"<code>LAME</code>" + major version + minor version + flag
+
  
If the version string is ever is less than 9 bytes, it is null-padded when written to the LAME tag.
+
LAME uses the Xing format for this header, and extends it by embedding a 20-byte "LAME tag" with additional info:
 +
* a short version string (9 ASCII bytes; see [[LAME version string]])
 +
* audio and info tag CRCs (since LAME 3.90)
 +
* separate delay & padding values for gapless playback (since LAME 3.90)
 +
* various encoder settings (since LAME 3.90, expanded in 3.94 to include presets)
  
The flag is normally one of the following:
+
Prior to LAME 3.94, the VBR header was only written in VBR files. Since 3.94, it is written to CBR files, too, with "Info" instead of "XING" at the beginning.
* "<code>a</code>" for alpha versions
+
* "<code>b</code>" for beta versions
+
* "<code>r</code>" for release versions with patch version > 0, starting with 3.96.1
+
* "<code> </code>" (space) for all other release versions with minor version < 100
+
* "" (empty string) for release versions with patch version = 0 and minor version > 99
+
  
For LAME 3.99.1, the format was changed such that release versions with a patch version > 0 would be identified with the following format:
+
Details are in this wiki's [[MP3#VBRI, XING, and LAME headers|MP3 article]] and [[LAME version string]] article, and in LAME developer Gabriel Bouvigne's [http://gabriel.mp3-tech.org/mp3infotag.html MP3 Info Tag] documentation.
:"<code>L</code>" + major version + "<code>.</code>" + minor version + flag + patch version
+
 
+
However, the new code contained a minor error which resulted in the patch version being omitted, and the change of "<code>LAME</code>" to "<code>L</code>" proved to be problematic for hardware and software players which failed to recognize the LAME tags as such, adversely affecting [[gapless]] playback and encoder identification, so the new scheme was abandoned for 3.99.2 and up.
+
 
+
Examples:
+
* 3.98 = 3.98.0 = "<code>LAME3.98</code>" followed by a space character (byte 0x20)
+
* 3.98.1 through 3.98.4 = "<code>LAME3.98r</code>"
+
* 3.99 alpha versions = "<code>LAME3.99a</code>"
+
* 3.99 beta versions = "<code>LAME3.99b</code>"
+
* 3.99 = 3.99.0 = "<code>LAME3.99</code>" followed by a space character
+
* 3.99.1 = "<code>L3.99r</code>" followed by three null characters (byte 0x00)
+
* 3.99.2 through 3.99.''n'' = "<code>LAME3.99r</code>"
+
* 3.100 alpha versions = "<code>LAME3100a</code>"
+
 
+
Related discussion thread:
+
* [http://www.hydrogenaudio.org/forums/index.php?showtopic=91372&view=findpost&p=775060 LAME 3.99 is out] (reports and discussion from 9 through 18 Nov 2011).
+
 
+
Related code:
+
* [http://lame.cvs.sourceforge.net/viewvc/lame/lame/libmp3lame/version.c?view=log version.c in CVS] (revisions 1.31 through 1.34)
+
  
 
==See also==
 
==See also==
 +
* [[LAME Y switch|The -Y switch]]
 
* [[MP3]]
 
* [[MP3]]
* [[Exact_Audio_Copy|Exact Audio Copy]]
+
* [[CBR]]
* [[EAC_and_Lame | Configuring EAC and LAME]]
+
* [[VBR]]
 
+
* [[ABR]]
 +
* [[Exact Audio Copy]]
 +
* [[EAC and Lame | Configuring EAC and LAME]]
  
 
==Notes and references==
 
==Notes and references==
:Please note that the following apply mostly to previous versions of this page and therefore may refer to outdated features, such as the famous --alt-presets, whose improvements have long since been folded into the main routines and default settings of LAME.
 
 
'''People who took part in suggesting the different settings:'''
 
 
Dibrom, r3mix, ff123, Hans Heijden, kjempen, Benjamin Lebsanft, GeSomeone, Wombat & GuruBoolez for his immense testing.
 
 
'''Creation of the alt preset system and related special code level quality enhancements:'''
 
 
Dibrom, with technical assistance from Robert Hegemann and Naoki Shibata, Gabriel and extensive tuning help and quality verification via listening tests from JohnV and also initial help (--dm-preset era) from Hans Heijden, ff123, Wombat, and others. Test clips, bitrate information, and further listening tests provided by TheBashar, zbutsam, Pio2001, BadDuDeX, r3mix, h, TarX, Hans Heijden, ff123, Wombat, Filburt, Volcano, Garf, MrDrew, TrNSZ, nyaochi, Amadeus93, in no particular order, and many, many others we (Dibrom, user) probably forgot to mention.
 
 
'''Idea (also exposing the need for a unified preset system), Original post and list of original settings collected by:'''
 
user
 
 
'''Layout and additional work by:''' dev0, CiTay, SNYder, Dibrom.
 
 
And finally...
 
 
Thank you ALL in the community for making it what it is, providing interest and discussion and helping to work towards the most concise, well tuned, and most thought out MP3 quality "paradigm" seen yet! -- Dibrom
 
 
===Footnotes===
 
 
<references/>
 
<references/>
 
==Further reading==
 
*[[CBR]]
 
*[[ABR]]
 
*[[VBR]]
 
*[[LAME_Y_SWITCH| The -Y switch]]
 
  
 
==External links==
 
==External links==

Revision as of 19:23, 10 September 2014

LAME
LAME official logo

LAME ain't an MP3 encoder
Developer(s) The LAME project
Release information
Initial release {{{released}}}
Stable release 3.99
Preview release 3.100
Compatibility
Operating system Windows, Mac OS/X, Linux/BSD
Additional information
Use Encoder/Decoder
License LGPL
Website LAME website
Featured article

LAME (Lame Ain't an MP3 Encoder) is the Hydrogenaudio recommended MP3 encoder. It has been developed by the open-source community since 1998, and has become the highest quality MP3 encoder for most purposes.

Some benefits of using LAME:

  • Highly optimised presets
  • Fast encoding
  • CBR, ABR and quality-optimized VBR encoding methods
  • Gapless playback with LAME-header compliant decoders
  • Supported by recommended CD rippers Exact Audio Copy and CDex
  • Highly tunable


History

LAME development began around mid-1998. Mike Cheng started it as a patch against the 8hz-MP3 encoder sources. After some quality concerns raised by others, he decided to start from scratch based on the dist10 sources.[1] That branch (a patch against the reference sources) became LAME 2.0. By the release of LAME 3.81, all dist10 code was removed, making LAME a completely new program, not a mere patch of an existing encoder.

The project quickly became a team effort. Mike Cheng eventually left leadership and started working on tooLAME, an MP2 encoder. Mark Taylor became leader and released version 3.0 featuring gpsycho, a new psychoacoustic model developed by him.

Nowadays LAME is considered the best MP3 encoder at mid & high bitrates, and features the best VBR model among MP3 implementations, mostly thanks to the dedicated work of talented developers Takehiro Tominaga, Naoki Shibata, Darin Morrison, Gabriel Bouvigne, Robert Hegemann, and others. Development is ongoing.

Although LAME is generally considered to be an encoder, according to the LAME technical FAQ, it's technically not an encoder, but rather is officially just "a development project which uses the open source model to improve MP3 technology." This improved technology is only released in source code form in order to minimize the risk of violating patents. When the source code is compiled and distributed, it may require a license from Thomson, depending on where and how it's to be used. The LAME project's position is "Source code is considered as speech, which may contain descriptions of patented technology. Descriptions of patents are in the public domain."

Recommended encoder compiles and source code

Unless noted otherwise, the recommended LAME compile for optimal quality is always the latest stable version.

It is suggested that the compiles available here be used with the recommended encoder settings you can find below.

Download the latest LAME from these links:

Avoid using alpha versions of LAME. These versions have "a" in their version string. More often than not those are exclusively for testing purposes. Use them only if you want to help developers with feedback.

Recommended encoder settings

This section describes the Hydrogenaudio recommended settings to be used with LAME for highest quality MP3 encoding. These settings require LAME 3.98 or later (the latest stable version is recommended).

Maximum quality and archiving

Maximum quality is achieved when, regardless of listening conditions, you are unable to detect a difference between the MP3 and the original. As demonstrated by blind ABX tests, LAME-encoded MP3s typically achieve this level of transparency when encoded with the default settings, at bitrates well below maximum. Encoding with other settings will have no effect on the quality.

For archiving, only lossless formats like WavPack, FLAC, etc. are ideal; they will preserve the audio with no changes, sample-for-sample, regardless of encoder settings. In contrast, lossy formats like MP3 are designed to save space by changing the audio in subtle, often imperceptible ways, even at the encoder's maximum settings.

Very high quality: HiFi, home, or quiet listening, with best file size

-V0 (~245 kbps), -V1 (~225 kbps), -V2 (~190 kbps) or -V3 (~175 kbps) are recommended.

These VBR settings will normally produce transparent results. Audible differences between these presets may exist, but are rare.

Very high quality: HiFi, home, or quiet listening, with maximum file size

-b 320 is an alternative to the VBR settings above.

This CBR mode will maximize the MP3's bitrate and overall file size. The extra space may allow for some parts of the audio to be compressed with fewer sacrifices, but to date, no one has produced ABX test results demonstrating that perceived quality is ever better than the highest VBR profiles described above.[2]

Portable: listening in noisy conditions, lower bitrate, smaller file size

-V4 (~165 kbps), -V5 (~130 kbps) or -V6 (~115 kbps) are recommended.

-V6 produces an "acceptable" quality, while -V4 should be close to perceptual transparency.

Very low bitrate, small sizes: eg. for voice, radio, mono encoding etc.

For very low bitrates, up to 100kbps, ABR is most often the best solution. Use --abr <bitrate> (e.g. --abr 80).

--preset voice is only available in the command line front-end, and is there for compatibility. It is currently mapped to --abr 56 -mm, so that means that the recommendation would be to encode in mono, and use ABR.

Understanding the bitrate settings

MP3s are divided into frames, each frame being a particular size, expressed as a bitrate. If the bitrate of every frame is the same throughout the file, then the file is considered to be constant bit rate (CBR). Otherwise, it is variable bit rate (VBR). LAME offers CBR and VBR encoding modes, as well as a special VBR encoding mode called ABR (average bit rate).

VBR (variable bitrate) settings

VBR: variable bitrate mode. Use variable bitrate modes when the goal is to achieve a fixed level of quality using the lowest possible bitrate.

VBR is best used to target a specific quality level, instead of a specific bitrate. The final file size of a VBR encode is less predictable than with ABR, but the quality is usually better.

Unlike other MP3 encoders which do VBR encoding based on predictions of output quality, LAME's default VBR method tests the actual output quality to ensure the desired quality level is always achieved.

Usage: -V <number> where <number> is 0-9, 0 being highest quality, 9 being the lowest.

Example: -V2 or -V 2

Note: The switch --vbr-new, which enabled a superior VBR mode in LAME 3.97 and some previous versions, is no longer needed with LAME 3.98 and higher, as it is now the default VBR mode. However, if you're still using LAME 3.97 or older, you have to add --vbr-new to your command line to use that mode.

The target bitrate and actual typical bitrate for each VBR quality level is shown in the Technical details for recommended LAME settings section below.

If you need a predictable bitrate (in a streaming application, for example), use ABR or CBR modes, described below.

ABR (average bitrate) settings

ABR: average bitrate mode. A compromise between VBR and CBR modes, ABR encoding varies bits around a specified target bitrate.

Use ABR when you need to know the final size of the file but still want to allow the encoder some flexibility to decide which passages need more bits. The output is an ordinary VBR file compatible with all MP3 players that support VBR; ABR is not a special type of file, just a LAME-specific strategy for producing VBR.

Usage: --preset <bitrate> where <bitrate> (desired averaged bitrate in kbit/s) is a value between 8 and 320.

Example: --preset 200

Important: ABR setting is tuned from 320 kbit/s down to 80 kbit/s.

CBR (constant bitrate) settings

CBR: constant bitrate mode. CBR encoding is not efficient. Whereas VBR and ABR modes can supply more bits to complex music passages and save bits on simpler ones, CBR encodes every frame at the same bitrate.

CBR is only recommended for usage in streaming situations where the upper bitrate must be strictly enforced. There is still some variability in bitrate behind the scenes, through LAME's use of the bit reservoir feature of the MP3 format, but it is much less flexible than actual VBR.

Usage: -b <bitrate> where <bitrate> (bitrate in kbit/s) must be chosen from the following values: 8, 16, 24, 32, 40, 48, 64, 80, 96, 112, 128, 160, 192, 224, 256, or 320.

Example: -b 192

Important: CBR setting is tuned from 320 kbit/s down to 80 kbit/s.

Remarks

  • The rule of thumb when considering encoding options: at a given bitrate, VBR is higher quality than ABR, which is higher quality than CBR (VBR > ABR > CBR in terms of quality). However, ABX tests demonstrate that as bitrate increases, the perceptual differences diminish, with all modes generally reaching transparency well before their maximum settings; when you can't tell the difference, the modes are qualitatively the same.
  • All modes and settings mentioned in this topic belong to the specifications of the MP3 standard, and the resulting MP3s should be playable by every MP3 decoder that conforms with the standard. If your decoder or device does not play MP3s produced by LAME, blame the manufacturer or developer, not LAME.
  • Prior to LAME 3.98, the --vbr-new switch enabled the new VBR mode. This is now the default VBR mode, with the old mode being available via --vbr-old. In terms of quality, the new mode appears to be better than the old, but reports of artifacts when using the new mode do exist. Despite these possible issues, the new mode is currently recommended due to both the speed and quality increases afforded by the new algorithm.

Hey! What happened to "--alt-preset"?

The revolutionary --alt-preset system was introduced in LAME 3.90; it was replaced by the --preset flags in later versions. Starting with version 3.94, the -Vx quality system was introduced, which allows finer control over the desired bitrate; the --preset switches were made into aliases to the corresponding -V flags for the sake of backwards compatibility. There is no difference between the output you get if you use -V2 or --alt-preset standard. (Although adding --vbr-new is recommended for now, see above for details.)

More encoding options are available under the new system, such as -V1, which provides a level of quality between the old "standard" and "extreme" presets, or -V3, which is between the old "medium" and "standard" presets.

Recent LAME versions feature more streamlined command-line options, and it's recommended to stick to one of the values described in the text or shown in the tables above.

For example, the following command-line options will all produce the same output:

  • --alt-preset insane
  • --preset insane
  • -b 320
  • --preset 320
  • --preset cbr 320

Technical information

Recommended settings details

Technical details of the recommended settings
Switch Preset Target Kbps Typical Kbps[3] Y Switch Lowpass[4] Resample
-b 320 --preset insane 320 320 Y[5]
-V 0 --preset fast extreme ~245 220–260
-V 1 ~225 190–250 19383 Hz – 19916 Hz
-V 2 --preset fast standard ~190 170–210 18671 Hz – 19205 Hz
-V 3 ~175 150–195 Y 17960 Hz – 18494 Hz
-V 4 --preset fast medium ~165 140–185 Y 17249 Hz – 17782 Hz
-V 5 ~130 120–150 Y 16538 Hz – 17071 Hz
-V 6 ~115 100–130 Y 15115 Hz – 15648 Hz
-V 7 ~100 80–120 Y 14581 Hz – 14968 Hz 32000 Hz
-V 8 ~85 70–105 Y 12516 Hz – 12903 Hz 32000 Hz
-V 9 ~65 45–85 Y 9336 Hz – 9602 Hz 24000 Hz

Fraunhofer decoder incompatibility

Differing interpretations of an unclear portion of the MP3 spec led to certain versions of the Fraunhofer IIS MP3 decoder being unable to properly play certain MP3s created with certain versions of LAME.

In order to demonstrate the problem, the problematic MP3 must have been created with LAME 3.97 or earlier, and must contain a frame with certain parameters and a very large amount of data, such as a 320-kbps frame which makes heavy use of the bit reservoir. The decoder must be the DirectShow filter l3codecx.ax version 1.5.0 or lower. That filter is the decoder used by Windows Media Player. The filter was upgraded to 1.6.0 by an August 2010 security update; the newer version can play the problematic MP3s.

A workaround was implemented in LAME 3.98.0 beta 1 through LAME 3.98.2, and in LAME 3.99 alpha 1, whereby 320-kbps frames were limited in how much of the bit reservoir they could use. This resulted in wasted space when the bit reservoir would grow beyond the limit. In LAME 3.98.3 and beyond, and in LAME 3.99 alpha 2 and beyond, the method was changed such that the bit reservoir can't grow beyond the limit.

Related discussion threads:

VBR header and LAME tag

LAME supports the de facto standard of adding an extra frame of silence to the beginning of MP3 files. This "VBR header" or "Info tag" provides a home for precise info about the audio duration and a table of seek points. It is mainly for the benefit of players working with VBR files. Decoders usually treat the frame as informational, rather than playing the audio.

LAME uses the Xing format for this header, and extends it by embedding a 20-byte "LAME tag" with additional info:

  • a short version string (9 ASCII bytes; see LAME version string)
  • audio and info tag CRCs (since LAME 3.90)
  • separate delay & padding values for gapless playback (since LAME 3.90)
  • various encoder settings (since LAME 3.90, expanded in 3.94 to include presets)

Prior to LAME 3.94, the VBR header was only written in VBR files. Since 3.94, it is written to CBR files, too, with "Info" instead of "XING" at the beginning.

Details are in this wiki's MP3 article and LAME version string article, and in LAME developer Gabriel Bouvigne's MP3 Info Tag documentation.

See also

Notes and references

  1. dist10 is the rudimentary "demonstration" MP3 encoder described in the MPEG-2 standard, ISO/IEC 13818.
  2. Prior to version 3.99, CBR and VBR modes were encoded differently by LAME. In some unusual problem samples, these differences were sometimes audible, even at very high bitrates. Current versions of LAME encode CBR and VBR with the same psychoacoustic model, so such differences shouldn't arise from normal use.
  3. Typical bitrates are mostly based on the results of testing with LAME 3.98.2.
  4. This range is the transition band of the lowpass filter. Signal components are at full intensity at the lower frequency. Higher frequencies are attenuated on a slope which reaches zero at (and beyond) the high end of the given range. Further info can be found in the HA forum.
  5. CBR mode uses -Y in effect; see the LAME Y Switch article.

External links