Copyright © 2008-2018 MultiMedia Soft

Appendix A - Lame encoder command line

Previous pageReturn to chapter overviewNext page

Lame encoder, used during the development of this product, is available for download from the following link.

Lame encoder latest build, with full source code, is available for download from its owner's website

 

Below you can find the full list of command line's options for Lame version 3.96.1:

 

LAME version 3.96.1 (http://lame.sourceforge.net/)

 

usage: lame [options] <infile> [outfile]

 

 <infile> and/or <outfile> can be "-", which means stdin/stdout.

 

RECOMMENDED:

 lame -h input.wav output.mp3

 

OPTIONS:

Input options:

 -r              input is raw pcm

 -x              force byte-swapping of input

 -s sfreq        sampling frequency of input file (kHz) - default 44.1 kHz

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

 --mp1input      input file is a MPEG Layer I   file

 --mp2input      input file is a MPEG Layer II  file

 --mp3input      input file is a MPEG Layer III file

 --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

 

Operational options:

 -m <mode>       (s)tereo, (j)oint, (f)orce, (m)ono

                 default is (s) or (j) depending on bitrate

                 force = force ms_stereo on all frames.

 -a              downmix from stereo to mono file for mono encoding

 --freeformat    produce a free format bitstream

 --decode        input=mp3 file, output=wav

 -t              disable writing wav header when using --decode

 --comp  <arg>   choose bitrate to achive a compression ratio of <arg>

 --scale <arg>   scale input (multiply PCM data) 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>

 --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

 --preset type   type must be "medium", "standard", "extreme", "insane",

                 or a value for an average desired bitrate and depending

                 on the value specified, appropriate quality settings will

                 be used.

                 "--preset help" gives more info on these

 

 

Verbosity:

 --disptime <arg>print progress report every arg seconds

 -S              don't print progress report, VBR histograms

 --nohist        disable VBR histogram display

 --silent        don't print anything on screen

 --quiet         don't print anything on screen

 --brief         print more useful information

 --verbose       print a lot of useful information

 

Noise shaping & psycho acoustic algorithms:

 -q <arg>        <arg> = 0...9.  Default  -q 5

                 -q 0:  Highest quality, very slow

                 -q 9:  Poor quality, but fast

 -h              Same as -q 2.   Recommended.

 -f              Same as -q 7.   Fast, ok quality

 

 

CBR (constant bitrate, the default) options:

 -b <bitrate>    set the bitrate in kbps, default 128 kbps

 --cbr           enforce use of constant bitrate

 

ABR options:

 --abr <bitrate> specify average bitrate desired (instead of quality)

 

VBR options:

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

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

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

 -V n            quality setting for VBR.  default n=4

                 0=high quality,bigger files. 9=smaller files

 -b <bitrate>    specify minimum allowed bitrate, default  32 kbps

 -B <bitrate>    specify maximum allowed bitrate, default 320 kbps

 -F              strictly enforce the -b option, for use with players that

                 do not support low bitrate mp3

 -t              disable writing LAME Tag

 -T              enable and force writing LAME Tag

 

 

ATH related:

 --noath         turns ATH down to a flat noise floor

 --athshort      ignore GPSYCHO for short blocks, use ATH only

 --athonly       ignore GPSYCHO completely, use ATH only

 --athtype n     selects between different ATH types [0-4]

 --athlower x    lowers ATH by x dB

 --athaa-type n  ATH auto adjust types 1-3, else no adjustment

 --athaa-loudapprox n   n=1 total energy or n=2 equal loudness curve

 --athaa-sensitivity x  activation offset in -/+ dB for ATH auto-adjustment

 

PSY related:

 --short         use short blocks when appropriate

 --noshort       do not use short blocks

 --allshort      use only short blocks

 --cwlimit <freq>  compute tonality up to freq (in kHz) default 8.8717

 --notemp        disable temporal masking effect

 --nssafejoint   M/S switching criterion

 --nsmsfix <arg> M/S switching tuning [effective 0-3.5]

 --interch x     adjust inter-channel masking ratio

 --ns-bass x     adjust masking for sfbs  0 -  6 (long)  0 -  5 (short)

 --ns-alto x     adjust masking for sfbs  7 - 13 (long)  6 - 10 (short)

 --ns-treble x   adjust masking for sfbs 14 - 21 (long) 11 - 12 (short)

 --ns-sfb21 x    change ns-treble by x dB for sfb21

 --shortthreshold x,y  short block switching threshold, x for L/R/M channel, y for S channel

Noise Shaping related:

 --substep n     use pseudo substep noise shaping method types 0-2

 

 

experimental switches:

 -X n[,m]        selects between different noise measurements

                 n for long block, m for short. if m is omitted, m = n

 -Y              lets LAME ignore noise in sfb21, like in CBR

 -Z [n]          toggles the scalefac-scale and subblock gain feature on

                 if n is set and minus, only scalefac-scale is enabled

 

 

MP3 header/stream options:

 -e <emp>        de-emphasis n/5/c  (obsolete)

 -c              mark as copyright

 -o              mark as non-original

 -p              error protection.  adds 16 bit checksum to every frame

                 (the checksum is computed correctly)

 --nores         disable the bit reservoir

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

 

Filter options:

 -k              keep ALL frequencies (disables all filters),

                 Can cause ringing and twinkling

--lowpass <freq>        frequency(kHz), lowpass filter cutoff above freq

--lowpass-width <freq>  frequency(kHz) - default 15% of lowpass freq

--highpass <freq>       frequency(kHz), highpass filter cutoff below freq

--highpass-width <freq> frequency(kHz) - default 15% of highpass freq

--resample <sfreq>  sampling frequency of output file(kHz)- default=automatic

 

 

ID3 tag options:

 --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>    audio/song track number (1 to 255, creates v1.1 tag)

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

 --add-id3v2     force addition of version 2 tag

 --id3v1-only    add only a version 1 tag

 --id3v2-only    add only a version 2 tag

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

 --pad-id3v2     pad version 2 tag with extra 128 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.

 

 

MS-Windows-specific options:

 --priority <type>     sets the process priority:

                            0,1 = Low priority (IDLE_PRIORITY_CLASS)

                            2 = normal priority (NORMAL_PRIORITY_CLASS, default)

                            3,4 = High priority (HIGH_PRIORITY_CLASS))

 Note: Calling '--priority' without a parameter will select priority 0.

 

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 80 96 112 128 144 160