% lame [options] inputfile [outputfile]

    inputfile and/or outputfile can be "-", which means stdin/stdout.

For more options, just type:

% lame --help  or lame --longhelp

Note: The HTML documentation is more complete than this text file.

=======================================================================

Constant Bitrate Examples:

=======================================================================

fixed bit rate jstereo 128 kbps encoding:

% lame -b128 sample.wav  sample.mp3

Use highest quality mode, slowest:

% lame -q0 -b128 sample.wav  sample.mp3

Use fast encode, low quality  (no noise shaping)

% lame -f -b128 sample.wav  sample.mp3

=======================================================================

Variable Bitrate Examples:

=======================================================================

LAME has two types of variable bitrate: ABR and VBR.

ABR is the type of variable bitrate encoding usually found in other

MP3 encoders, Vorbis and AAC.  The number of bits is determined by

some metric (like perceptual entropy, or just the number of bits

needed for a certain set of encoding tables), and it is not based on

computing the actual encoding/quantization error.  ABR should always

give results equal or better than CBR:

ABR:   (--abr <x> means encode with an average bitrate of around x kbps)

% lame --abr 128  sample.wav sample.mp3

Another way to enable abr is:

% lame --preset 128 sample.wav sample.mp3

VBR is a true variable bitrate mode which bases the number of bits for

each frame on the measured quantization error relative to the

estimated allowed masking. The value 0 is the highest quality, which

creates bigger files, and the lowest is 9.999, which creates the smallest

files. Decimal values can be specified, like: 4.51.

The resulting filesizes depend on the input material. On typical music 

you can expect -V5 resulting in files averaging 132 kbps, -V2 averaging 

200 kbps.

Variable Bitrate (VBR): (use -V n to adjust quality/filesize)

% lame -V2 sample.wav sample.mp3

=======================================================================

Low Bitrates

=======================================================================

At lower bitrates, (like 24 kbps per channel), it is recommended that

you use a 16 kHz sampling rate combined with lowpass filtering.  LAME,

as well as commercial encoders (FhG, Xing) will do this automatically.

However, if you feel there is too much (or not enough) lowpass

filtering, you may need to try different values of the lowpass cutoff

and passband width (--resample, --lowpass and --lowpass-width options).

=======================================================================

Streaming Example

=======================================================================

% cat inputfile | lame [options] - - > output

=======================================================================

Scripts are included (in the 'misc' subdirectory)

to run lame on multiple files:

bash script:  mlame      Run "mlame -?" for instructions.

sh script:    auenc      Run auenc for instructions

sh script:    mugeco.sh

Perl script which will re-encode mp3 files and preserve id3 tags:

lameid3.pl

Windows scripts:

lame4dos.bat

Lame.vbs   (and an HTML frontend: LameGUI.html)

=======================================================================

options guide:

=======================================================================

These options are explained in detail below.

By default, LAME accepts a PCM audio sample inside a .WAV container as the

input file, in 8, 16, 24 and 32 bits integer and in IEEE FLOAT.

If it is compiled with libsndfile, then it also supports the extra formats

that the library supports.

There is also support for raw PCM data and piped input

Input options:

--scale <arg>   multiply PCM input by <arg>

--scale-l <arg> scale channel 0 (left) input (multiply PCM data) by <arg>

--scale-r <arg> scale channel 1 (right) input (multiply PCM data) by <arg>

--gain number   apply Gain adjustment in decibels, range -20.0 to +12.0.

--swap-channel	Swap Left and Right input channels

--mp1input      input file is an MPEG 1 Layer I file.  decode on the fly

--mp2input      input file is an MPEG 1 Layer II file.  decode on the fly

--mp3input      input file is an MPEG 1 Layer III file.  decode on the fly

--nogap <file1> <file2> <...>

                gapless encoding for a set of contiguous files

--nogapout <dir>

                output dir for gapless encoding (must precede --nogap)

--nogaptags     allow the use of VBR tags in gapless encoding

--out-dir path	If no explicit output file is specified, a file will be

                written at given path. Ignored when using piped/streamed input

Input options for raw PCM:

-r              read the input file as a raw (headerless) PCM stream

-s  n           input sampling frequency in kHz (Default 44.1Khz)

--signed        input is signed (default)

--unsigned      input is unsigned

--bitwidth w    input bit width is w (default 16)

-x              swap bytes of input file

--little-endian input is little-endian (default)

--big-endian    input is big-endian

-a              downmix stereo file to mono file for mono encoding.

                Needed with raw input for the -mm mode to do the downmix.

Resampling and filtering:

--lowpass      Frequency(kHz), lowpass filter cutoff above freq.

               Range [0.001..50]kHz or [50..50000]Hz

--lowpass-width

               Frequency(kHz), lowpass window width.

			   Range [0.001..16]kHz or [16..50000]Hz

			   (See further restriction in the detailed explanation)

--highpass     Frequency(kHz), highpass filter cutoff below freq.

               Range [0.001..16]kHz or [16..50000]Hz

               (See further restriction in the detailed explanation)

--highpass-width

               Frequency(kHz), highpass window width

               (See further restriction in the detailed explanation)

--resample n   Sampling frequency of output file(kHz)

               Default=automatic depending on settings like bitrate.

Operational:

--preset type	Enables some preconfigured settings. Check below for each

                of the valid values

--decode        assume input file is an mp3 file, and decode to wav.

--decode-mp3delay samples

                Set the encoder delay to use to decode the input .mp3 file

-t              disable writing of WAV header when using --decode

                (decode to raw pcm, native endian format (use -x to swap))

-m m/s/j/f/a   mode selection

-q n           Internal algorithm quality setting 0..9.

               0 = slowest algorithms, but potentially highest quality

               9 = faster algorithms, very poor quality

			   Default is 3. Read the differences between VBR and CBR below.

-h             same as -q2

-f             same as -q7

--priority <type>

               sets the process priority (Windows and OS/2-specific):

                     0,1 = Low priority (IDLE_PRIORITY_CLASS)

                     2 = normal priority (NORMAL_PRIORITY_CLASS, defaul

                     3,4 = High priority (HIGH_PRIORITY_CLASS))

               Note: Calling '--priority' without a parameter will set it to 0.

Constant Bit Rate (CBR)

-b  n          set bitrate (8, 16, 24, ..., 320)

--freeformat   produce a free format bitstream.  User must also specify

               a bitrate with -b, between 8 and 640 kbps.

Variable Bit Rate (VBR)

-v             VBR  ( alias of -V 4 )

--vbr-old      use old variable bitrate (VBR) routine

--vbr-new      use new variable bitrate (VBR) routine (default)

-V n           VBR quality setting  (0=highest quality, 9.999=lowest)

-b  n          specify a minimum allowed bitrate (8,16,24,...,320)

-B  n          specify a maximum allowed bitrate (8,16,24,...,320)

-F             strictly enforce minimum bitrate

-t             disable VBR informational tag

--nohist       disable display of VBR bitrate histogram

--abr n        specify average bitrate desired

MP3 header/stream options:

-e  n/5/c       de-emphasis

-p              add CRC error protection

-c              mark the encoded file as copyrighted

-o              mark the encoded file as a copy

-S              don't print progress report, VBR histogram

--strictly-enforce-ISO   comply as much as possible to ISO MPEG spec

--replaygain-fast   compute RG fast but slightly inaccurately (default)

--replaygain-accurate   compute RG more accurately and find the peak sample

--noreplaygain  disable ReplayGain analysis

--clipdetect    enable --replaygain-accurate and print a message whether

                clipping occurs and how far the waveform is from full scale

ID3 tagging:

--tt <title>    audio/song title (max 30 chars for version 1 tag)

--ta <artist>   audio/song artist (max 30 chars for version 1 tag)

--tl <album>    audio/song album (max 30 chars for version 1 tag)

--ty <year>     audio/song year of issue (1 to 9999)

--tc <comment>  user-defined text (max 30 chars for v1 tag, 28 for v1.1)

--tn <track[/total]>

                audio/song track number (1 to 255, creates v1.1 tag.

                adding a total force a version 2 tag)

--tg <genre>    audio/song genre (name or number in list)

--ti <file>     audio/song albumArt (jpeg/png/gif file, v2.3 tag)

--tv <id=value> user-defined frame specified by id and value (v2.3 tag)

--add-id3v2     force addition of version 2 tag

--id3v1-only    add only a version 1 tag

--id3v2-only    add only a version 2 tag

--id3v2-utf16   add following options in unicode text encoding

--id3v2-latin1  add following options in latin-1 text encoding

--space-id3v1   pad version 1 tag with spaces instead of nulls

--pad-id3v2     same as '--pad-id3v2-size 128'

--pad-id3v2-size <num>

                adds version 2 tag, pad with extra <num> bytes

--genre-list    print alphabetically sorted ID3 genre list and exit

--ignore-tag-errors

                ignore errors in values passed for tags

Note: A version 2 tag will NOT be added unless one of the input fields

won't fit in a version 1 tag (e.g. the title string is longer than 30

characters), or the '--add-id3v2' or '--id3v2-only' options are used,

or output is redirected to stdout.

Verbosity:

--disptime     secs	Print progress report every secs seconds

--nohist	   Disable VBR histogram display

--silent       Don't print anything on screen

--quiet        Don't print anything on screen

--verbose	   Print a lot of useful information

--version      Print License information

--license	   Print License information

--help         Shows the common list of switches.

               Add id3 or dev to get help for a specified topic

--usage        Shows the common list of switches.

               Add id3 or dev to get help for a specified topic

--longhelp     Shows the complete list of switches

=======================================================================

Detailed description of all options in alphabetical order

=======================================================================

=======================================================================

Downmix

=======================================================================

-a

mix the stereo input file to mono and encode as mono.

This option is only needed in the case of raw PCM stereo input

(because LAME cannot determine the number of channels in the input file).

To encode a stereo (RAW) PCM input file as mono, use "lame -m m -a"

For WAV and AIFF input files, using "-m m" will always produce a

mono .mp3 file from both mono and stereo input.

=======================================================================

Average bitrate encoding (aka Safe VBR)

=======================================================================

--abr n

turns on encoding with a targeted average bitrate of n kbps, allowing

to use frames of different sizes.  The allowed range of n is 8...320

kbps, you can use any integer value within that range.

=======================================================================

Use version 2 of the ID3 tag standard

=======================================================================

 --add-id3v2 Force addition of version 2 tag

Tells LAME to add the tag information as id3v2. This implies adding both,

a version 1 and a version 2 tag, if the values fit on a version 1 tag.

See --id3v1-only and --id3v2-only if you want a more fine-grained control.

=======================================================================

Bitrate

=======================================================================

-b  n

MPEG-1   layer III sample frequencies (kHz):  32  48  44.1

bitrates (kbps): 32 40 48 56 64 80 96 112 128 160 192 224 256 320

MPEG-2   layer III sample frequencies (kHz):  16  24  22.05

bitrates (kbps):  8 16 24 32 40 48 56 64 80 96 112 128 144 160

MPEG-2.5 layer III sample frequencies (kHz):   8  12  11.025

bitrates (kbps):  8 16 24 32 40 48 56 64

The bitrate to be used.  Default is 128kbps in MPEG1 (64 for mono),

64kbps in MPEG2 (32 for mono) and 32kbps in MPEG2.5 (16 for mono).

When used with variable bitrate encodings (VBR), -b specifies the

minimum bitrate to use.  This is useful only if you need to circumvent

a buggy hardware device with strange bitrate constrains.

=======================================================================

Max bitrate

=======================================================================

-B  n

see also option "-b" for allowed bitrates.

Maximum allowed bitrate when using VBR/ABR.

Using -B is NOT RECOMMENDED.  A 128 kbps CBR bitstream, because of the

bit reservoir, can actually have frames which use as many bits as a

320 kbps frame.  ABR/VBR modes minimize the use of the bit reservoir, and

thus need to allow 320 kbps frames to get the same flexability as CBR

streams.  This is useful only if you need to circumvent a buggy hardware

device with strange bitrate constrains.

=======================================================================

Endianess, big.

=======================================================================

 --big-endian Set the byte order to big-endian.

This switch tells LAME that the RAW pcm input is encoded in big-endian

instead of little-endian.

=======================================================================

Sample bit with

=======================================================================

--bitwidth Sets the bitwidth value

With RAW pcm input, this switch lets you specify the bitwidth of the same

(8 bits, 16 bits...)

=======================================================================

Copyright

=======================================================================

-c

flag the encoded file as copyrighted

=======================================================================

Clipping detection

=======================================================================

--clipdetect

Enable --replaygain-accurate and print a message whether clipping

occurs and how far in dB the waveform is from full scale.

This option is not usable if the MP3 decoder was _explicitly_ disabled

in the build of LAME.

See also: --replaygain-accurate

=======================================================================

MPEG audio decode capability

=======================================================================

--decode

This uses LAME's HIP decoder to decode an MP3 file (layers 1, 2 and 3) to

a wav file.

If -t is used (disable wav header), LAME will output

raw pcm in native endian format (use -x to swap bytes).

This option is not usable if the MP3 decoder was _explicitly_ disabled

in the build of LAME.

HIP stands for Hip Isn't a Player and is based off of Michael Hipp's mpglib 0.2a

=======================================================================

MPEG audio decode capability

=======================================================================

--decode-mp3delay x Indicate a different encoder delay for decoding

When decoding an mp3 file, LAME automatically corrects for the start delay

that the encoder had to put into it. This setting lets you specify a different

delay than LAME's own one, so that it is possible to compensate for the delay

of mp3's generated with other encoders.

=======================================================================

De-emphasis

=======================================================================

-e  n/5/c

  n = (none, default)

  5 = 0/15 microseconds

  c = CCITT j.17

All this does is set a flag in the bitstream.  If you have a PCM

input file where one of the above types of (obsolete) emphasis has

been applied, you can set this flag in LAME.  Then the mp3 decoder

should de-emphasize the output during playback, although most

decoders ignore this flag.

A better solution would be to apply the de-emphasis with a standalone

utility before encoding, and then encode without -e.

=======================================================================

Strictly enforce VBR minimum bitrate

=======================================================================

-F

strictly enforce VBR minimum bitrate.   Without this option, passages of

analog silence will be encoded at the minimum bitrate possible (32 or 8,

depending on MPEG version).

=======================================================================

Free format bitstreams

=======================================================================

--freeformat

LAME will produce a fixed bitrate, free format bitstream. User must 

specify the desired bitrate in kbps, which can be any integer between 

8 and 640.

Not supported by most decoders.  Complient decoders (of which there

are few) are only required to support up to 320 kbps.

Decoders known to handle free format:

                      supports up to

mpg123                   640 kbps

MAD                      640 kbps

"lame --decode"          640 kbps

l3dec                    310 kbps

=======================================================================

Gain

=======================================================================

--gain Apply gain in decibels.

Apply Gain adjustment in decibels, range -20.0 to +12.0. 0dBFS means no 

amplification.

=======================================================================

High pass filter

=======================================================================

--highpass number Use a highpass filter when encoding

Enables a highpass filter of the specified frequency when encoding the source.

    Range [0.001..50]kHz or [50..50000]Hz.

This is usually not required, and the gains are usually minimal. May be useful

to remove an interference signal on 50Hz or 60Hz, or a DC offset.

(default: disabled)

Note: The current implementation has a minimum highpass frequency of

(67.5/62)% of the sample rate (I.e. 481Hz at 44Khz).

=======================================================================

High pass filter

=======================================================================

--highpass-width width Set the width of the decaying curve.

Specify the width in Hz of the decaying curve of the highpass.

    Range [16..50000]Hz

The minimum (and default) width is 75% of a band's width (which is 1/64th of

 the sample rate).

Note: See the remark in the --highpass command above.

=======================================================================

ID3 tag modes

=======================================================================

--id3v1-only Disable the use of id3v2.

Put it before any tag setting.

This setting tells LAME to use ID3 v1 tag only, and not create an ID3v2

even if it thinks it should.

--id3v2-only Disable the user ov id3v1.

Put it before any tag setting.

This setting tells LAME to use ID3 v2 tag only. An ID3 v1 tag would not

be written.

--ignore-tag-errors Ignore tag information errors

Put it before any tag setting.

This tells lame to ignore the tag information it sees as erroneous and 

continue encoding without those. Without this setting, errors are reported

and encoding does not start.

=======================================================================

Endianess. little

=======================================================================

--little-endian Set the byte order to little-endian.

This switch tells LAME that the RAW pcm input is encoded in little-endian.

It is the default setting.

=======================================================================

Low pass filter

=======================================================================

--lowpass number Use a lowpass filter when encoding

Enables a lowpass filter of the specified frequency when encoding the source.

    Range [0.001..50]kHz or [50..50000]Hz

Using a lowpass filter helps reducing the amount of data to encode. This is

important in MP3 due to a limitation in very high frequencies (>16Khz).

The default value depends on the target bitrate/quality. It is not recommended

to change it as a general basis.

--lowpass-width width Set the width of the decaying curve.

Specify the width in Hz of the decaying curve of the lowpass.

    Range [0.001..16]kHz or [16..50000]Hz

The lowpass is in the center of this curve. The minimum (and default) width

is 75% of a band's width (which is 1/64th of the sample rate).

=======================================================================

Modes:

=======================================================================

-m m        mono

-m l	    get only the left channel of a stereo signal for a mono output

-m r	    get only the right channel of a stereo signal for a mono output

-m s        (forced) L/R stereo

-m j        joint stereo

-m f        forced mid/side stereo

-m d        dual (independent) channels. Its purpose was meant for dual language

            streams where only one of them should be decoded.

			Most decoders just decode them as a stereo stream.

-m a        Currently, a synonym of m j. (In older releases it selected

            different modes depending on the bitrate)

MONO is the default mode for mono input files.  If "-m m" is specified

for a stereo input file, the two channels will be averaged into a mono

signal.  (Note: See comments about the -a switch for RAW PCM streams)

(FORCED) L/R STEREO encodes the left and the right signals independently,

and gives more or less bits to each, depending on the currently available.

JOINT STEREO is the default mode of encoding.

jstereo means the encoder can use (on a frame by frame basis) either

L/R stereo or mid/side stereo.  In mid/side stereo, the mid(L+R) and side(L-R)

channels are encoded, and more bits are allocated to the mid channel

than the side channel.  When there isn't too much stereo separation, this

effectively increases the bandwidth, so having higher quality with the same

amount of bits.

Using mid/side stereo inappropriately can result in audible

compression artifacts.  Too much switching between mid/side and L/R

stereo can also sound bad. To determine when to switch to mid/side

stereo, LAME uses a much more sophisticated algorithm than that

described in the ISO documentation.

FORCED MID/SIDE STEREO forces all frames to be encoded mid/side stereo.  It

should only be used if you are sure every frame of the input file

has very little stereo seperation.

DUAL CHANNEL mode is similar to encode the left and right as two mono signals.

Its purpose was meant for Dual language streams where only one of them should

be decoded. Most decoders just decode them as a stereo stream

INTENSITY STEREO

	Not supported.

=======================================================================

MP3 input file

=======================================================================

--mp1input --mp2input --mp3input MPEG layer I, II or III input file

Assume the input file is a MP1/2/3 file.  LAME will decode the input file

before re-encoding it.  Since MP3 is a lossy format, this is not recommended 

in general.  But it is useful for creating low bitrate mp3s from high bitrate 

mp3s.  If the filename ends in ".mp3" LAME will assume it is an MP3.  For 

stdin or MP3 files which dont end in .mp3 you need to use this switch.

=======================================================================

No Gap (continuous audio) encoding of multiple files

=======================================================================

 --nogap file1 file2 [...] Encodes multiple continuous files.

Encodes multiple files (ordered by position) which are meant to be played

gaplessly.

By default, LAME will encode the files with accurate length, but the first

and last frame may contain a few erroneous samples for signals that don't

fade-in/out (as is the case of continuous playback).

This setting solves that by using the samples from the next/previous file to

compute the encoding.

--nogapout dir Specify a directory for the output of the files encoded

               with --nogap

This setting should precede --nogap, and is used to specify the alternate

directory where to store the encoded files. The default one is the input file

directory.

--nogaptags Enables the use of VBR tags with files encoded with --nogap

Tells LAME to put VBR tags to encoded files if they are encoded in VBR or ABR

modes. Else, using the --nogap option doesn't generate it.

=======================================================================

Disable historgram display

=======================================================================

--nohist

By default, LAME will display a bitrate histogram while producing

VBR mp3 files.  This will disable that feature.

=======================================================================

Disable ReplayGain analysis

=======================================================================

--noreplaygain

By default ReplayGain analysis is enabled. This switch disables it.

See also: --replaygain-accurate, --replaygain-fast

=======================================================================

Non-original

=======================================================================

-o

mark the encoded file as a copy

=======================================================================

CRC error protection

=======================================================================

-p

Turn on CRC error protection.

It will add a cyclic redundancy check (CRC) code in each frame, allowing

to detect transmission errors that could occur on the MP3 stream. However,

it takes 16 bits per frame that would otherwise be used for encoding, and

therefore will slightly reduce the sound quality.

=======================================================================

ID3 V2 padding

=======================================================================

 --pad-id3v2 Pad ID3v2 tag.

Pads the ID3v2 tag with extra 128bytes to allow it to expand.

=======================================================================

Preset system.

=======================================================================

--preset x Enable one of the presets

   Setting         Meaning

--preset medium	   -V 5

--preset standard  -V 2

--preset extreme   -V 0

--preset insane    -b 320

--preset fast xxx  In versions older than LAME 3.98, "fast" was needed to

                   enable the vbr-new routine. It is no longer needed.

--preset number	   --abr number

--preset cbr number	-b number

Old compatibility settings. Meaningless

--preset phone	   -b 16 -m m

--preset phon+ /

      lw / mw-eu   -b 24 -m m

--preset mw-us     -b 40 -m m

--preset voice     -b 56 -m m

--preset fm / radio -b 112

--preset hifi      -b 160

--preset cd        -b 192

--preset studio    -b 256

=======================================================================

Windows and OS/2 process priority control

=======================================================================

--priority <type>

(Windows and OS/2 only)

Sets the process priority for LAME while running under Windows or IBM OS/2.

This can be very useful to avoid the system becoming slow and/or unresponsive. 

By setting LAME to run in a lower priority, you leave more time for the system 

to update basic processing (drawing windows, polling keyboard/mouse, etc). The 

impact in LAME's performance is minimal if you use priority 0 to 2.

The valid parameters are:

     0 = Low priority (IDLE, delta = 0)

     1 = Medium priority (IDLE, delta = +31)

     2 = Regular priority (REGULAR, delta = -31)

     3 = High priority (REGULAR, delta = 0)

     4 = Maximum priority (REGULAR, delta = +31)

Note that if you call '--priority' without a parameter, priority 0 will be 

assumed.

=======================================================================

Algorithm quality selection

=======================================================================

-q n

Bitrate is of course the main influence on quality. The higher the bitrate,

the higher the quality. But for a given bitrate, we have a choice of algorithms

to determine the best scalefactors and Huffman coding (noise shaping).

For CBR, ABR and --vbr-old modes, the following table applies

-q 0            Use the best algorithms (Best Huffman coding search, full outer

                loop, and the highest precision of several parameters).

-q 1 to -q 4    Similar to -q 0 without the full outer loop and decreasing

                precision of parameters the further from q0. -q 3 is the default

-q 5 and -q 6   Same as -q 7, but enables noise shaping and increases subblock

                gain

-q 7 to -q 9    Same as -f. Very fast, OK quality. Psychoacoustics are used for

                pre-echo and mid/side stereo, but no noise-shaping is done.

For the default VBR mode since LAME 3.98, the following table applies

-q 0 to -q 4    include all features of the other modes and additionally use

                the best search when applying Huffman coding.

-q 5 and -q 6   include all features of -q7, calculate and consider actual

                quantisation noise, and additionally enable subblock gain.

-q 7 to -q 9    This level uses a psymodel but does not calculate quantisation

                noise when encoding: it takes a quick guess.

=======================================================================

Input file is raw pcm

=======================================================================

-r

Assume the input file is raw pcm.  Sampling rate and mono/stereo/jstereo

must be specified on the command line.  Without -r, LAME will perform

several fseek()'s on the input file looking for WAV and AIFF headers.

Not supported if LAME is compiled to use LIBSNDFILE.

=======================================================================

Slightly more accurate ReplayGain analysis and finding the peak sample

=======================================================================

--replaygain-accurate

Compute "Radio" ReplayGain on the decoded data stream. Find the peak sample

by decoding on the fly the encoded data stream and store it in the file.

ReplayGain analysis does _not_ affect the content of a compressed data

stream itself, it is a value stored in the header of a sound file.

Information on the purpose of ReplayGain and the algorithms used is

available from http://www.replaygain.org/

By default, LAME performs ReplayGain analysis on the input data (after

the user-specified volume scaling). This behaviour might give slightly

inaccurate results because the data on the output of a lossy

compression/decompression sequence differs from the initial input data.

When --replaygain-accurate is specified the mp3 stream gets decoded on

the fly and the analysis is performed on the decoded data stream.

Although theoretically this method gives more accurate results, it has

several disadvantages:

  * tests have shown that the difference between the ReplayGain values

    computed on the input data and decoded data is usually no greater

    than 0.5dB, although the minimum volume difference the human ear

    can perceive is about 1.0dB

  * decoding on the fly significantly slows down the encoding process

The apparent advantage is that:

  * with --replaygain-accurate the peak sample is determined and

    stored in the file. The knowledge of the peak sample can be useful

    to decoders (players) to prevent a negative effect called 'clipping'

    that introduces distortion into sound.

Only the "Radio" ReplayGain value is computed. It is stored in the LAME tag.

The analysis is performed with the reference volume equal to 89dB.

Note: the reference volume has been changed from 83dB on transition from 

version 3.95 to 3.95.1.

This option is not usable if the MP3 decoder was _explicitly_ disabled

in the build of LAME. (Note: if LAME is compiled without the MP3 decoder,

ReplayGain analysis is performed on the input data after user-specified

volume scaling).

See also: --replaygain-fast, --noreplaygain, --clipdetect

=======================================================================

Fast ReplayGain analysis

=======================================================================

--replaygain-fast

Compute "Radio" ReplayGain of the input data stream after user-specified

volume scaling and/or resampling.

ReplayGain analysis does _not_ affect the content of a compressed data

stream itself, it is a value stored in the header of a sound file.

Information on the purpose of ReplayGain and the algorithms used is

available from http://www.replaygain.org/

Only the "Radio" ReplayGain value is computed. It is stored in the LAME tag.

The analysis is performed with the reference volume equal to 89dB.

Note: the reference volume has been changed from 83dB on transition

from version 3.95 to 3.95.1.

This switch is enabled by default.

See also: --replaygain-accurate, --noreplaygain

=======================================================================

Output sampling frequency in kHz

=======================================================================

--resample  n

where n = 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, 48. The values as Hz

instead of Khz are also supported. Else, the value will be ignored.

Output sampling frequency.  Resample the input if necessary.

If not specified, LAME may sometimes resample automatically

when faced with extreme compression conditions (like encoding

a 44.1 kHz input file at 32 kbps).  To disable this automatic

resampling, you have to use --resamle to set the output samplerate

equal to the input samplerate.  In that case, LAME will not

perform any extra computations.

=======================================================================

Sampling frequency in kHz (for input RAW PCM)

=======================================================================

-s  n

where n = sampling rate in kHz.

Required for raw PCM input files.  Otherwise it will be determined

from the header information in the input file.

LAME will automatically resample the input file to one of the

supported MP3 samplerates if necessary.

=======================================================================

Silent operation

=======================================================================

-S

don't print progress report

=======================================================================