|
Packit |
47f805 |
.TH lame 1 "December 08, 2013" "LAME 3.99" "LAME audio compressor"
|
|
Packit |
47f805 |
.SH NAME
|
|
Packit |
47f805 |
lame \- create mp3 audio files
|
|
Packit |
47f805 |
.SH SYNOPSIS
|
|
Packit |
47f805 |
lame [options] <infile> <outfile>
|
|
Packit |
47f805 |
.SH DESCRIPTION
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
LAME is a program which can be used to create compressed audio files.
|
|
Packit |
47f805 |
(Lame ain't an MP3 encoder).
|
|
Packit |
47f805 |
These audio files can be played back by popular MP3 players such as
|
|
Packit |
47f805 |
mpg123 or madplay.
|
|
Packit |
47f805 |
To read from stdin, use "\-" for <infile>.
|
|
Packit |
47f805 |
To write to stdout, use "\-" for <outfile>.
|
|
Packit |
47f805 |
.SH OPTIONS
|
|
Packit |
47f805 |
Input options:
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-r
|
|
Packit |
47f805 |
Assume the input file is raw pcm.
|
|
Packit |
47f805 |
Sampling rate and mono/stereo/jstereo must be specified on the command line.
|
|
Packit |
47f805 |
For each stereo sample, LAME expects the input data to be ordered left channel
|
|
Packit |
47f805 |
first, then right channel. By default, LAME expects them to be signed integers
|
|
Packit |
47f805 |
with a bitwidth of 16 and stored in little-endian.
|
|
Packit |
47f805 |
Without
|
|
Packit |
47f805 |
.B \-r,
|
|
Packit |
47f805 |
LAME will perform several
|
|
Packit |
47f805 |
.I fseek()'s
|
|
Packit |
47f805 |
on the input file looking for WAV and AIFF headers.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
Might not be available on your release.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-x
|
|
Packit |
47f805 |
Swap bytes in the input file (or output file when using
|
|
Packit |
47f805 |
.B \-\-decode).
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
For sorting out little endian/big endian type problems.
|
|
Packit |
47f805 |
If your encodings sounds like static,
|
|
Packit |
47f805 |
try this first.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
Without using
|
|
Packit |
47f805 |
.B \-x,
|
|
Packit |
47f805 |
LAME will treat input file as native endian.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-s " sfreq"
|
|
Packit |
47f805 |
.I sfreq
|
|
Packit |
47f805 |
= 8/11.025/12/16/22.05/24/32/44.1/48
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Required only for raw PCM input files.
|
|
Packit |
47f805 |
Otherwise it will be determined from the header of the input file.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
LAME will automatically resample the input file to one of the supported
|
|
Packit |
47f805 |
MP3 samplerates if necessary.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-bitwidth " n"
|
|
Packit |
47f805 |
Input bit width per sample.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
= 8, 16, 24, 32 (default 16)
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Required only for raw PCM input files.
|
|
Packit |
47f805 |
Otherwise it will be determined from the header of the input file.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-signed
|
|
Packit |
47f805 |
Instructs LAME that the samples from the input are signed (the default
|
|
Packit |
47f805 |
for 16, 24 and 32 bits raw pcm data).
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Required only for raw PCM input files.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-unsigned
|
|
Packit |
47f805 |
Instructs LAME that the samples from the input are unsigned (the default
|
|
Packit |
47f805 |
for 8 bits raw pcm data, where 0x80 is zero).
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Required only for raw PCM input files
|
|
Packit |
47f805 |
and only available at bitwidth 8.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-little-endian
|
|
Packit |
47f805 |
Instructs LAME that the samples from the input are in little-endian form.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Required only for raw PCM input files.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-big-endian
|
|
Packit |
47f805 |
Instructs LAME that the samples from the input are in big-endian form.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Required only for raw PCM input files.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-mp1input
|
|
Packit |
47f805 |
Assume the input file is a MPEG Layer I (ie MP1) file.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
If the filename ends in ".mp1" LAME will assume it is a MPEG Layer I file.
|
|
Packit |
47f805 |
For stdin or Layer I files which do not end in .mp1 you need to use
|
|
Packit |
47f805 |
this switch.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-mp2input
|
|
Packit |
47f805 |
Assume the input file is a MPEG Layer II (ie MP2) file.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
If the filename ends in ".mp2" LAME will assume it is a MPEG Layer II file.
|
|
Packit |
47f805 |
For stdin or Layer II files which do not end in .mp2 you need to use
|
|
Packit |
47f805 |
this switch.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-mp3input
|
|
Packit |
47f805 |
Assume the input file is a MP3 file.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
Useful for downsampling from one mp3 to another.
|
|
Packit |
47f805 |
As an example,
|
|
Packit |
47f805 |
it can be useful for streaming through an IceCast server.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
If the filename ends in ".mp3" LAME will assume it is an MP3.
|
|
Packit |
47f805 |
For stdin or MP3 files which do not end in .mp3 you need to use this switch.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-nogap " file1 file2 ..."
|
|
Packit |
47f805 |
gapless encoding for a set of contiguous files
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-nogapout " dir"
|
|
Packit |
47f805 |
output dir for gapless encoding (must precede \-\-nogap)
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-out-dir " dir"
|
|
Packit |
47f805 |
If no explicit output file is specified, a file will be written at given path.
|
|
Packit |
47f805 |
Ignored when using piped/streamed input
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
Operational options:
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-m " mode"
|
|
Packit |
47f805 |
.I mode
|
|
Packit |
47f805 |
= s, j, f, d, m, l, r
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Joint-stereo is the default mode for stereo files.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B (s)imple stereo (Forced LR)
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
In this mode,
|
|
Packit |
47f805 |
the encoder makes no use of potentially existing correlations between
|
|
Packit |
47f805 |
the two input channels.
|
|
Packit |
47f805 |
It can,
|
|
Packit |
47f805 |
however,
|
|
Packit |
47f805 |
negotiate the bit demand between both channel,
|
|
Packit |
47f805 |
i.e. give one channel more bits if the other contains silence or needs
|
|
Packit |
47f805 |
less bits because of a lower complexity.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B (j)oint stereo
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
In this mode,
|
|
Packit |
47f805 |
the encoder can use (on a frame by frame basis) either L/R stereo or mid/side stereo.
|
|
Packit |
47f805 |
In mid/side stereo,
|
|
Packit |
47f805 |
the mid (L+R) and side (L-R) channels are encoded,
|
|
Packit |
47f805 |
and more bits are allocated to the mid channel than the side channel.
|
|
Packit |
47f805 |
When there isn't too much stereo separation, this effectively increases the bandwidth,
|
|
Packit |
47f805 |
so having higher quality with the same amount of bits.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Using mid/side stereo inappropriately can result in audible compression artifacts.
|
|
Packit |
47f805 |
Too much switching between mid/side and regular stereo can also sound bad.
|
|
Packit |
47f805 |
To determine when to switch to mid/side stereo,
|
|
Packit |
47f805 |
LAME uses a much more sophisticated algorithm than the one described in the ISO documentation.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B (f)orced MS stereo
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
Forces all frames to be encoded with mid/side stereo. It should be used only if you are sure that every frame of the input file has very little stereo separation.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B (d)ual channel
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
In this mode,
|
|
Packit |
47f805 |
the 2 channels will be totally independently encoded.
|
|
Packit |
47f805 |
Each channel will have exactly half of the bitrate.
|
|
Packit |
47f805 |
This mode is designed for applications like dual languages
|
|
Packit |
47f805 |
encoding (for example: English in one channel and French in the other).
|
|
Packit |
47f805 |
Using this encoding mode for regular stereo files will result in a
|
|
Packit |
47f805 |
lower quality encoding.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B (m)ono
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
The input will be encoded as a mono signal.
|
|
Packit |
47f805 |
If it was a stereo signal,
|
|
Packit |
47f805 |
it will be downsampled to mono.
|
|
Packit |
47f805 |
The downmix is calculated as the sum of the left and right channel,
|
|
Packit |
47f805 |
attenuated by 6 dB.
|
|
Packit |
47f805 |
Also note that, if using a stereo RAW PCM stream, you need to use the -a parameter.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B (l)eft channel only
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
The input will be encoded as a mono signal.
|
|
Packit |
47f805 |
If it was a stereo signal,
|
|
Packit |
47f805 |
the left channel will be encoded only.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B (r)ight channel only
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
The input will be encoded as a mono signal.
|
|
Packit |
47f805 |
If it was a stereo signal,
|
|
Packit |
47f805 |
the right channel will be encoded only.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-a
|
|
Packit |
47f805 |
Mix the stereo input file to mono and encode as mono.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
The downmix is calculated as the sum of the left and right channel,
|
|
Packit |
47f805 |
attenuated by 6 dB.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
This option is only needed in the case of raw PCM stereo input
|
|
Packit |
47f805 |
(because LAME cannot determine the number of channels in the input file).
|
|
Packit |
47f805 |
To encode a stereo RAW PCM input file as mono,
|
|
Packit |
47f805 |
use
|
|
Packit |
47f805 |
.B lame \-a \-m m
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
For WAV and AIFF input files,
|
|
Packit |
47f805 |
using
|
|
Packit |
47f805 |
.B \-m m
|
|
Packit |
47f805 |
will always produce a mono .mp3 file from both mono and stereo input.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-freeformat
|
|
Packit |
47f805 |
Produces a free format bitstream.
|
|
Packit |
47f805 |
With this option,
|
|
Packit |
47f805 |
you can use
|
|
Packit |
47f805 |
.B \-b
|
|
Packit |
47f805 |
with any bitrate higher than 8 kbps.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
However,
|
|
Packit |
47f805 |
even if an mp3 decoder is required to support free bitrates at
|
|
Packit |
47f805 |
least up to 320 kbps,
|
|
Packit |
47f805 |
many players are unable to deal with it.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Tests have shown that the following decoders support free format:
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.B in_mpg123
|
|
Packit |
47f805 |
up to 560 kbps
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.B l3dec
|
|
Packit |
47f805 |
up to 310 kbps
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.B LAME
|
|
Packit |
47f805 |
up to 640 kbps
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.B MAD
|
|
Packit |
47f805 |
up to 640 kbps
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-decode
|
|
Packit |
47f805 |
Uses LAME for decoding to a wav file.
|
|
Packit |
47f805 |
The input file can be any input type supported by encoding,
|
|
Packit |
47f805 |
including layer II files.
|
|
Packit |
47f805 |
LAME uses a fork of mpglib known as HIP for decoding.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
If
|
|
Packit |
47f805 |
.B \-t
|
|
Packit |
47f805 |
is used (disable wav header),
|
|
Packit |
47f805 |
LAME will output raw pcm in native endian format.
|
|
Packit |
47f805 |
You can use
|
|
Packit |
47f805 |
.B \-x
|
|
Packit |
47f805 |
to swap bytes order.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
This option is not usable if the MP3 decoder was
|
|
Packit |
47f805 |
.B explicitly
|
|
Packit |
47f805 |
disabled in the build of LAME.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-t
|
|
Packit |
47f805 |
Disable writing of the INFO Tag on encoding.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
This tag is embedded in frame 0 of the MP3 file.
|
|
Packit |
47f805 |
It includes some information about the encoding options of the file,
|
|
Packit |
47f805 |
and in VBR it lets VBR aware players correctly seek and compute
|
|
Packit |
47f805 |
playing times of VBR files.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
When
|
|
Packit |
47f805 |
.B \-\-decode
|
|
Packit |
47f805 |
is specified (decode to WAV),
|
|
Packit |
47f805 |
this flag will disable writing of the WAV header.
|
|
Packit |
47f805 |
The output will be raw pcm,
|
|
Packit |
47f805 |
native endian format.
|
|
Packit |
47f805 |
Use
|
|
Packit |
47f805 |
.B \-x
|
|
Packit |
47f805 |
to swap bytes.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-comp " arg"
|
|
Packit |
47f805 |
Instead of choosing bitrate,
|
|
Packit |
47f805 |
using this option,
|
|
Packit |
47f805 |
user can choose compression ratio to achieve.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-scale " n"
|
|
Packit |
47f805 |
.PD 0
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-scale\-l " n"
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-scale\-r " n"
|
|
Packit |
47f805 |
Scales input (every channel, only left channel or only right channel) by
|
|
Packit |
47f805 |
.I n.
|
|
Packit |
47f805 |
This just multiplies the PCM data (after it has been converted to floating
|
|
Packit |
47f805 |
point) by
|
|
Packit |
47f805 |
.I n.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
> 1: increase volume
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
= 1: no effect
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
< 1: reduce volume
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Use with care,
|
|
Packit |
47f805 |
since most MP3 decoders will truncate data which decodes to values
|
|
Packit |
47f805 |
greater than 32768.
|
|
Packit |
47f805 |
.PD
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-replaygain\-fast
|
|
Packit |
47f805 |
Compute ReplayGain fast but slightly inaccurately.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
This computes "Radio" ReplayGain on the input data stream after
|
|
Packit |
47f805 |
user\(hyspecified volume\(hyscaling and/or resampling.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
The ReplayGain analysis does
|
|
Packit |
47f805 |
.I not
|
|
Packit |
47f805 |
affect the content of a compressed data stream itself,
|
|
Packit |
47f805 |
it is a value stored in the header of a sound file.
|
|
Packit |
47f805 |
Information on the purpose of ReplayGain and the algorithms used is
|
|
Packit |
47f805 |
available from
|
|
Packit |
47f805 |
.B http://www.replaygain.org/.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Only the "RadioGain" Replaygain value is computed,
|
|
Packit |
47f805 |
it is stored in the LAME tag.
|
|
Packit |
47f805 |
The analysis is performed with the reference
|
|
Packit |
47f805 |
volume equal to 89dB.
|
|
Packit |
47f805 |
Note: the reference volume has been changed from 83dB on transition from
|
|
Packit |
47f805 |
version 3.95 to 3.95.1.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
This switch is enabled by default.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
See also:
|
|
Packit |
47f805 |
.B \-\-replaygain\-accurate, \-\-noreplaygain
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-replaygain\-accurate
|
|
Packit |
47f805 |
Compute ReplayGain more accurately and find the peak sample.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
This computes "Radio" ReplayGain on the decoded data stream,
|
|
Packit |
47f805 |
finds the peak sample by decoding on the fly the encoded data stream and stores it in the file.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
The ReplayGain analysis does
|
|
Packit |
47f805 |
.I not
|
|
Packit |
47f805 |
affect the content of a compressed data stream itself,
|
|
Packit |
47f805 |
it is a value stored in the header of a sound file.
|
|
Packit |
47f805 |
Information on the purpose of ReplayGain and the algorithms used is
|
|
Packit |
47f805 |
available from
|
|
Packit |
47f805 |
.B http://www.replaygain.org/.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
By default, LAME performs ReplayGain analysis on the input data
|
|
Packit |
47f805 |
(after the user\(hyspecified volume scaling).
|
|
Packit |
47f805 |
This behavior might give slightly inaccurate results
|
|
Packit |
47f805 |
because the data on the output of a lossy compression/decompression sequence
|
|
Packit |
47f805 |
differs from the initial input data.
|
|
Packit |
47f805 |
When
|
|
Packit |
47f805 |
.B \-\-replaygain-accurate
|
|
Packit |
47f805 |
is specified the mp3 stream gets decoded on the fly and the analysis is
|
|
Packit |
47f805 |
performed on the decoded data stream.
|
|
Packit |
47f805 |
Although theoretically this method gives more accurate results,
|
|
Packit |
47f805 |
it has several disadvantages:
|
|
Packit |
47f805 |
.RS 8
|
|
Packit |
47f805 |
.IP "*" 4
|
|
Packit |
47f805 |
tests have shown that the difference between the ReplayGain values computed
|
|
Packit |
47f805 |
on the input data and decoded data is usually not greater than 0.5dB,
|
|
Packit |
47f805 |
although the minimum volume difference the human ear can perceive is
|
|
Packit |
47f805 |
about 1.0dB
|
|
Packit |
47f805 |
.IP "*" 4
|
|
Packit |
47f805 |
decoding on the fly significantly slows down the encoding process
|
|
Packit |
47f805 |
.RE
|
|
Packit |
47f805 |
.RS 7
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
The apparent advantage is that:
|
|
Packit |
47f805 |
.RE
|
|
Packit |
47f805 |
.RS 8
|
|
Packit |
47f805 |
.IP "*" 4
|
|
Packit |
47f805 |
with
|
|
Packit |
47f805 |
.B \-\-replaygain-accurate
|
|
Packit |
47f805 |
the real peak sample is determined and stored in the file.
|
|
Packit |
47f805 |
The knowledge of the peak sample can be useful to decoders (players)
|
|
Packit |
47f805 |
to prevent a negative effect called 'clipping' that introduces distortion
|
|
Packit |
47f805 |
into the sound.
|
|
Packit |
47f805 |
.RE
|
|
Packit |
47f805 |
.RS 7
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Only the "RadioGain" ReplayGain value is computed,
|
|
Packit |
47f805 |
it is stored in the LAME tag.
|
|
Packit |
47f805 |
The analysis is performed with the reference
|
|
Packit |
47f805 |
volume equal to 89dB.
|
|
Packit |
47f805 |
Note: the reference volume has been changed from 83dB on transition from
|
|
Packit |
47f805 |
version 3.95 to 3.95.1.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
This option is not usable if the MP3 decoder was
|
|
Packit |
47f805 |
.B explicitly
|
|
Packit |
47f805 |
disabled in the build of LAME.
|
|
Packit |
47f805 |
(Note: if LAME is compiled without the MP3 decoder,
|
|
Packit |
47f805 |
ReplayGain analysis is performed on the input data after user-specified
|
|
Packit |
47f805 |
volume scaling).
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
See also:
|
|
Packit |
47f805 |
.B \-\-replaygain-fast, \-\-noreplaygain \-\-clipdetect
|
|
Packit |
47f805 |
.RE
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-noreplaygain
|
|
Packit |
47f805 |
Disable ReplayGain analysis.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
By default ReplayGain analysis is enabled. This switch disables it.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
See also:
|
|
Packit |
47f805 |
.B \-\-replaygain-fast, \-\-replaygain-accurate
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-clipdetect
|
|
Packit |
47f805 |
Clipping detection.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Enable
|
|
Packit |
47f805 |
.B \-\-replaygain-accurate
|
|
Packit |
47f805 |
and print a message whether clipping occurs and how far in dB the waveform
|
|
Packit |
47f805 |
is from full scale.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
This option is not usable if the MP3 decoder was
|
|
Packit |
47f805 |
.B explicitly
|
|
Packit |
47f805 |
disabled in the build of LAME.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
See also:
|
|
Packit |
47f805 |
.B \-\-replaygain-accurate
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-preset " type | [cbr] kbps"
|
|
Packit |
47f805 |
Use one of the built-in presets.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Have a look at the PRESETS section below.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B \-\-preset help
|
|
Packit |
47f805 |
gives more infos about the the used options in these presets.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-noasm " type"
|
|
Packit |
47f805 |
Disable specific assembly optimizations (
|
|
Packit |
47f805 |
.B mmx
|
|
Packit |
47f805 |
/
|
|
Packit |
47f805 |
.B 3dnow
|
|
Packit |
47f805 |
/
|
|
Packit |
47f805 |
.B sse
|
|
Packit |
47f805 |
).
|
|
Packit |
47f805 |
Quality will not increase, only speed will be reduced.
|
|
Packit |
47f805 |
If you have problems running Lame on a Cyrix/Via processor,
|
|
Packit |
47f805 |
disabling mmx optimizations might solve your problem.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
Verbosity:
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-disptime " n"
|
|
Packit |
47f805 |
Set the delay in seconds between two display updates.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-nohist
|
|
Packit |
47f805 |
By default,
|
|
Packit |
47f805 |
LAME will display a bitrate histogram while producing VBR mp3 files.
|
|
Packit |
47f805 |
This will disable that feature.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
Histogram display might not be available on your release.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B -S
|
|
Packit |
47f805 |
.PD 0
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-silent
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-quiet
|
|
Packit |
47f805 |
Do not print anything on the screen.
|
|
Packit |
47f805 |
.PD
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-verbose
|
|
Packit |
47f805 |
Print a lot of information on the screen.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-help
|
|
Packit |
47f805 |
Display a list of available options.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
Noise shaping & psycho acoustic algorithms:
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI -q " qual"
|
|
Packit |
47f805 |
0 <=
|
|
Packit |
47f805 |
.I qual
|
|
Packit |
47f805 |
<= 9
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Bitrate is of course the main influence on quality.
|
|
Packit |
47f805 |
The higher the bitrate,
|
|
Packit |
47f805 |
the higher the quality.
|
|
Packit |
47f805 |
But for a given bitrate,
|
|
Packit |
47f805 |
we have a choice of algorithms to determine the best scalefactors
|
|
Packit |
47f805 |
and Huffman encoding (noise shaping).
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
For CBR and ABR, the following table applies:
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -q 0:
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
Use the best algorithms (Best Huffman coding search, full outer loop, and the highest precision of several parameters).
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -q 1 to q 4:
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
Similar to -q 0 without the full outer loop and decreasing precision of parameters the further from q0. -q 3 is the default.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -q 5 and -q 6:
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
Same as -q 7, but enables noise shaping and increases subblock gain
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -q 7 to -q 9:
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
Same as -f. Very fast, OK quality. Psychoacoustics are used for pre-echo and mid/side stereo, but no noise-shaping is done.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
For the default VBR mode since LAME 3.98, the following table applies :
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -q 0 to -q 4:
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
include all features of the other modes and additionally use the best search when applying Huffman coding.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -q 5 and -q 6:
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
include all features of -q7, calculate and consider actual quantisation noise, and additionally enable subblock gain.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -q 7 to -q 9
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
This level uses a psymodel but does not calculate quantisation noise when encoding: it takes a quick guess.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B -h
|
|
Packit |
47f805 |
Alias of
|
|
Packit |
47f805 |
.B -q 2
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B -f
|
|
Packit |
47f805 |
Alias of
|
|
Packit |
47f805 |
.B -q 7
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
CBR (constant bitrate, the default) options:
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI -b " n"
|
|
Packit |
47f805 |
For MPEG-1 (sampling frequencies of 32, 44.1 and 48 kHz)
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
= 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
For MPEG-2 (sampling frequencies of 16, 22.05 and 24 kHz)
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
= 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
For MPEG-2.5 (sampling frequencies of 8, 11.025 and 12 kHz)
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
= 8, 16, 24, 32, 40, 48, 56, 64
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Default is 128 for MPEG1 and 64 for MPEG2 and 32 for MPEG2.5
|
|
Packit |
47f805 |
(64, 32 and 16 respectively in case of mono).
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-cbr
|
|
Packit |
47f805 |
enforce use of constant bitrate. Used to disable VBR or ABR encoding even if their settings
|
|
Packit |
47f805 |
are enabled.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
ABR (average bitrate) options:
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-abr " n"
|
|
Packit |
47f805 |
Turns on encoding with a targeted average bitrate of n kbits,
|
|
Packit |
47f805 |
allowing to use frames of different sizes.
|
|
Packit |
47f805 |
The allowed range of
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
is 8 - 310,
|
|
Packit |
47f805 |
you can use any integer value within that range.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
It can be combined with the
|
|
Packit |
47f805 |
.B -b
|
|
Packit |
47f805 |
and
|
|
Packit |
47f805 |
.B -B
|
|
Packit |
47f805 |
switches like:
|
|
Packit |
47f805 |
.B lame \-\-abr
|
|
Packit |
47f805 |
.I 123
|
|
Packit |
47f805 |
.B -b
|
|
Packit |
47f805 |
.I 64
|
|
Packit |
47f805 |
.B -B
|
|
Packit |
47f805 |
.I 192 a.wav a.mp3
|
|
Packit |
47f805 |
which would limit the allowed frame sizes between 64 and 192 kbits.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
The use of
|
|
Packit |
47f805 |
.B -B
|
|
Packit |
47f805 |
is NOT RECOMMENDED.
|
|
Packit |
47f805 |
A 128 kbps CBR bitstream,
|
|
Packit |
47f805 |
because of the bit reservoir,
|
|
Packit |
47f805 |
can actually have frames which use as many bits as a 320 kbps frame.
|
|
Packit |
47f805 |
VBR modes minimize the use of the bit reservoir,
|
|
Packit |
47f805 |
and thus need to allow 320 kbps frames to get the same flexibility
|
|
Packit |
47f805 |
as CBR streams.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
VBR (variable bitrate) options:
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B -v
|
|
Packit |
47f805 |
use variable bitrate
|
|
Packit |
47f805 |
.B (\-\-vbr-new)
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-vbr-old
|
|
Packit |
47f805 |
Invokes the oldest,
|
|
Packit |
47f805 |
most tested VBR algorithm.
|
|
Packit |
47f805 |
It produces very good quality files,
|
|
Packit |
47f805 |
though is not very fast.
|
|
Packit |
47f805 |
This has,
|
|
Packit |
47f805 |
up through v3.89,
|
|
Packit |
47f805 |
been considered the "workhorse" VBR algorithm.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-vbr-new
|
|
Packit |
47f805 |
Invokes the newest VBR algorithm.
|
|
Packit |
47f805 |
During the development of version 3.90,
|
|
Packit |
47f805 |
considerable tuning was done on this algorithm,
|
|
Packit |
47f805 |
and it is now considered to be on par with the original
|
|
Packit |
47f805 |
.B \-\-vbr-old.
|
|
Packit |
47f805 |
It has the added advantage of being very fast (over twice as fast as
|
|
Packit |
47f805 |
.B \-\-vbr-old
|
|
Packit |
47f805 |
). This is the default since 3.98.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI -V " n"
|
|
Packit |
47f805 |
0 <=
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
<= 9.999
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
Enable VBR (Variable BitRate) and specifies the value of VBR quality
|
|
Packit |
47f805 |
(default = 4). Decimal values can be specified, like 4.51.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
0 = highest quality.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
ABR and VBR options:
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI -b " bitrate"
|
|
Packit |
47f805 |
For MPEG-1 (sampling frequencies of 32, 44.1 and 48 kHz)
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
= 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
For MPEG-2 (sampling frequencies of 16, 22.05 and 24 kHz)
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
= 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
For MPEG-2.5 (sampling frequencies of 8, 11.025 and 12 kHz)
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
= 8, 16, 24, 32, 40, 48, 56, 64
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Specifies the minimum bitrate to be used.
|
|
Packit |
47f805 |
However,
|
|
Packit |
47f805 |
in order to avoid wasted space,
|
|
Packit |
47f805 |
the smallest frame size available will be used during silences.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI -B " bitrate"
|
|
Packit |
47f805 |
For MPEG-1 (sampling frequencies of 32, 44.1 and 48 kHz)
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
= 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
For MPEG-2 (sampling frequencies of 16, 22.05 and 24 kHz)
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
= 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 144, 160
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
For MPEG-2.5 (sampling frequencies of 8, 11.025 and 12 kHz)
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
= 8, 16, 24, 32, 40, 48, 56, 64
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Specifies the maximum allowed bitrate.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Note: If you own an mp3 hardware player build upon a MAS 3503 chip,
|
|
Packit |
47f805 |
you must set maximum bitrate to no more than 224 kpbs.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B -F
|
|
Packit |
47f805 |
Strictly enforce the
|
|
Packit |
47f805 |
.B -b
|
|
Packit |
47f805 |
option.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
This is mainly for use with hardware players that do not support low
|
|
Packit |
47f805 |
bitrate mp3.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Without this option,
|
|
Packit |
47f805 |
the minimum bitrate will be ignored for passages of analog silence,
|
|
Packit |
47f805 |
i.e. when the music level is below the absolute threshold of
|
|
Packit |
47f805 |
human hearing (ATH).
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
Experimental options:
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI -X " n"
|
|
Packit |
47f805 |
0 <=
|
|
Packit |
47f805 |
.I n
|
|
Packit |
47f805 |
<= 7
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
When LAME searches for a "good" quantization,
|
|
Packit |
47f805 |
it has to compare the actual one with the best one found so far.
|
|
Packit |
47f805 |
The comparison says which one is better,
|
|
Packit |
47f805 |
the best so far or the actual.
|
|
Packit |
47f805 |
The
|
|
Packit |
47f805 |
.B -X
|
|
Packit |
47f805 |
parameter selects between different approaches to make this decision,
|
|
Packit |
47f805 |
.B -X0
|
|
Packit |
47f805 |
being the default mode:
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -X0
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
The criteria are (in order of importance):
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
* less distorted scalefactor bands
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
* the sum of noise over the thresholds is lower
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
* the total noise is lower
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -X1
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
The actual is better if the maximum noise over all scalefactor bands is
|
|
Packit |
47f805 |
less than the best so far.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -X2
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
The actual is better if the total sum of noise is lower than the best so
|
|
Packit |
47f805 |
far.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -X3
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
The actual is better if the total sum of noise is lower than the best so
|
|
Packit |
47f805 |
far and the maximum noise over all scalefactor bands is less than the
|
|
Packit |
47f805 |
best so far plus 2dB.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -X4
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
Not yet documented.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -X5
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
The criteria are (in order of importance):
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
* the sum of noise over the thresholds is lower
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
* the total sum of noise is lower
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -X6
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
The criteria are (in order of importance):
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
* the sum of noise over the thresholds is lower
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
* the maximum noise over all scalefactor bands is lower
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
* the total sum of noise is lower
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.B -X7
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
The criteria are:
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
* less distorted scalefactor bands
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
or
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
* the sum of noise over the thresholds is lower
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B -Y
|
|
Packit |
47f805 |
lets LAME ignore noise in sfb21, like in CBR
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
MP3 header/stream options:
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI -e " emp"
|
|
Packit |
47f805 |
.I emp
|
|
Packit |
47f805 |
= n, 5, c
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
n = (none, default)
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
5 = 0/15 microseconds
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
c = citt j.17
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
All this does is set a flag in the bitstream.
|
|
Packit |
47f805 |
If you have a PCM input file where one of the above types of
|
|
Packit |
47f805 |
(obsolete) emphasis has been applied,
|
|
Packit |
47f805 |
you can set this flag in LAME.
|
|
Packit |
47f805 |
Then the mp3 decoder should de-emphasize the output during playback,
|
|
Packit |
47f805 |
although most decoders ignore this flag.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
A better solution would be to apply the de-emphasis with a standalone
|
|
Packit |
47f805 |
utility before encoding,
|
|
Packit |
47f805 |
and then encode without
|
|
Packit |
47f805 |
.B -e.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B -c
|
|
Packit |
47f805 |
Mark the encoded file as being copyrighted.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B -o
|
|
Packit |
47f805 |
Mark the encoded file as being a copy.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B -p
|
|
Packit |
47f805 |
Turn on CRC error protection.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
It will add a cyclic redundancy check (CRC) code in each frame,
|
|
Packit |
47f805 |
allowing to detect transmission errors that could occur on the
|
|
Packit |
47f805 |
MP3 stream.
|
|
Packit |
47f805 |
However,
|
|
Packit |
47f805 |
it takes 16 bits per frame that would otherwise be used for encoding,
|
|
Packit |
47f805 |
and then will slightly reduce the sound quality.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-nores
|
|
Packit |
47f805 |
Disable the bit reservoir.
|
|
Packit |
47f805 |
Each frame will then become independent from previous ones,
|
|
Packit |
47f805 |
but the quality will be lower.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-strictly-enforce-ISO
|
|
Packit |
47f805 |
With this option,
|
|
Packit |
47f805 |
LAME will enforce the 7680 bit limitation on total frame size.
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
This results in many wasted bits for high bitrate encodings but will
|
|
Packit |
47f805 |
ensure strict ISO compatibility.
|
|
Packit |
47f805 |
This compatibility might be important for hardware players.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
Filter options:
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-lowpass " freq"
|
|
Packit |
47f805 |
Set a lowpass filtering frequency in kHz.
|
|
Packit |
47f805 |
Frequencies above the specified one will be cutoff.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-lowpass-width " freq"
|
|
Packit |
47f805 |
Set the width of the lowpass filter.
|
|
Packit |
47f805 |
The default value is 15% of the lowpass frequency.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-highpass " freq"
|
|
Packit |
47f805 |
Set an highpass filtering frequency in kHz.
|
|
Packit |
47f805 |
Frequencies below the specified one will be cutoff.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-highpass-width " freq"
|
|
Packit |
47f805 |
Set the width of the highpass filter in kHz.
|
|
Packit |
47f805 |
The default value is 15% of the highpass frequency.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-resample " sfreq"
|
|
Packit |
47f805 |
.I sfreq
|
|
Packit |
47f805 |
= 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, 48
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
Select output sampling frequency (only supported for encoding).
|
|
Packit |
47f805 |
.br
|
|
Packit |
47f805 |
If not specified,
|
|
Packit |
47f805 |
LAME will automatically resample the input when using high compression ratios.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
ID3 tag options:
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-tt " title"
|
|
Packit |
47f805 |
audio/song title (max 30 chars for version 1 tag)
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-ta " artist"
|
|
Packit |
47f805 |
audio/song artist (max 30 chars for version 1 tag)
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-tl " album"
|
|
Packit |
47f805 |
audio/song album (max 30 chars for version 1 tag)
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-ty " year"
|
|
Packit |
47f805 |
audio/song year of issue (1 to 9999)
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-tc " comment"
|
|
Packit |
47f805 |
user-defined text (max 30 chars for v1 tag, 28 for v1.1)
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-tn " track[/total]"
|
|
Packit |
47f805 |
audio/song track number and (optionally) the total number of tracks on
|
|
Packit |
47f805 |
the original recording. (track and total each 1 to 255. Providing
|
|
Packit |
47f805 |
just the track number creates v1.1 tag, providing a total forces v2.0).
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-tg " genre"
|
|
Packit |
47f805 |
audio/song genre (name or number in list)
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.BI \-\-tv " id=value"
|
|
Packit |
47f805 |
Text or URL frame specified by id and value (v2.3 tag). User defined frame. Syntax: \-\-tv "TXXX=description=content"
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-add-id3v2
|
|
Packit |
47f805 |
force addition of version 2 tag
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-id3v1-only
|
|
Packit |
47f805 |
add only a version 1 tag
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-id3v2-only
|
|
Packit |
47f805 |
add only a version 2 tag
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-id3v2-latin1
|
|
Packit |
47f805 |
add following options in ISO-8859-1 text encoding.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-id3v2-utf16
|
|
Packit |
47f805 |
add following options in unicode text encoding.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-space-id3v1
|
|
Packit |
47f805 |
pad version 1 tag with spaces instead of nulls
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-pad-id3v2
|
|
Packit |
47f805 |
same as \-\-pad-id3v2-size 128
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-pad-id3v2-size "num"
|
|
Packit |
47f805 |
adds version 2 tag, pad with extra "num" bytes
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-genre-list
|
|
Packit |
47f805 |
print alphabetically sorted ID3 genre list and exit
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-ignore-tag-errors
|
|
Packit |
47f805 |
ignore errors in values passed for tags, use defaults in case an error occurs
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
Analysis options:
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-g
|
|
Packit |
47f805 |
run graphical analysis on <infile>.
|
|
Packit |
47f805 |
<infile> can also be a .mp3 file.
|
|
Packit |
47f805 |
(This feature is a compile time option.
|
|
Packit |
47f805 |
Your binary may for speed reasons be compiled without this.)
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.SH ID3 TAGS
|
|
Packit |
47f805 |
LAME is able to embed ID3 v1,
|
|
Packit |
47f805 |
v1.1 or v2 tags inside the encoded MP3 file.
|
|
Packit |
47f805 |
This allows to have some useful information about the music track
|
|
Packit |
47f805 |
included inside the file.
|
|
Packit |
47f805 |
Those data can be read by most MP3 players.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Lame will smartly choose which tags to use.
|
|
Packit |
47f805 |
It will add ID3 v2 tags only if the input comments won't fit in v1
|
|
Packit |
47f805 |
or v1.1 tags,
|
|
Packit |
47f805 |
i.e. if they are more than 30 characters.
|
|
Packit |
47f805 |
In this case,
|
|
Packit |
47f805 |
both v1 and v2 tags will be added,
|
|
Packit |
47f805 |
to ensure reading of tags by MP3 players which are unable to read ID3 v2 tags.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.SH ENCODING MODES
|
|
Packit |
47f805 |
LAME is able to encode your music using one of its 3 encoding modes:
|
|
Packit |
47f805 |
constant bitrate (CBR), average bitrate (ABR) and variable bitrate (VBR).
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B Constant Bitrate (CBR)
|
|
Packit |
47f805 |
This is the default encoding mode,
|
|
Packit |
47f805 |
and also the most basic.
|
|
Packit |
47f805 |
In this mode,
|
|
Packit |
47f805 |
the bitrate will be the same for the whole file.
|
|
Packit |
47f805 |
It means that each part of your mp3 file will be using the same
|
|
Packit |
47f805 |
number of bits.
|
|
Packit |
47f805 |
The musical passage being a difficult one to encode or an easy one,
|
|
Packit |
47f805 |
the encoder will use the same bitrate,
|
|
Packit |
47f805 |
so the quality of your mp3 is variable.
|
|
Packit |
47f805 |
Complex parts will be of a lower quality than the easiest ones.
|
|
Packit |
47f805 |
The main advantage is that the final files size won't change and
|
|
Packit |
47f805 |
can be accurately predicted.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B Average Bitrate (ABR)
|
|
Packit |
47f805 |
In this mode,
|
|
Packit |
47f805 |
you choose the encoder will maintain an average bitrate while using
|
|
Packit |
47f805 |
higher bitrates for the parts of your music that need more bits.
|
|
Packit |
47f805 |
The result will be of higher quality than CBR encoding but the
|
|
Packit |
47f805 |
average file size will remain predictable,
|
|
Packit |
47f805 |
so this mode is highly recommended over CBR.
|
|
Packit |
47f805 |
This encoding mode is similar to what is referred as vbr in AAC or
|
|
Packit |
47f805 |
Liquid Audio (2 other compression technologies).
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B Variable bitrate (VBR)
|
|
Packit |
47f805 |
In this mode,
|
|
Packit |
47f805 |
you choose the desired quality on a scale from 9 (lowest
|
|
Packit |
47f805 |
quality/biggest distortion) to 0 (highest quality/lowest distortion).
|
|
Packit |
47f805 |
Then encoder tries to maintain the given quality in the whole file by
|
|
Packit |
47f805 |
choosing the optimal number of bits to spend for each part of your music.
|
|
Packit |
47f805 |
The main advantage is that you are able to specify the quality level that
|
|
Packit |
47f805 |
you want to reach,
|
|
Packit |
47f805 |
but the inconvenient is that the final file size is totally unpredictable.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.SH PRESETS
|
|
Packit |
47f805 |
The
|
|
Packit |
47f805 |
.B \-\-preset
|
|
Packit |
47f805 |
switches are aliases over LAME settings.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
To activate these presets:
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
For VBR modes (generally highest quality):
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-preset medium
|
|
Packit |
47f805 |
This preset should provide near transparency to most people on most music.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-preset standard
|
|
Packit |
47f805 |
This preset should generally be transparent to most people on most music and
|
|
Packit |
47f805 |
is already quite high in quality.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-preset extreme
|
|
Packit |
47f805 |
If you have extremely good hearing and similar equipment,
|
|
Packit |
47f805 |
this preset will generally provide slightly higher quality than the
|
|
Packit |
47f805 |
.B standard
|
|
Packit |
47f805 |
mode.
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
For CBR 320kbps (highest quality possible from the
|
|
Packit |
47f805 |
.B \-\-preset
|
|
Packit |
47f805 |
switches):
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-preset insane
|
|
Packit |
47f805 |
This preset will usually be overkill for most people and most situations,
|
|
Packit |
47f805 |
but if you must have the absolute highest quality with no regard to filesize,
|
|
Packit |
47f805 |
this is the way to go.
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
For ABR modes (high quality per given bitrate but not as high as VBR):
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B \-\-preset " kbps"
|
|
Packit |
47f805 |
Using this preset will usually give you good quality at a specified bitrate.
|
|
Packit |
47f805 |
Depending on the bitrate entered,
|
|
Packit |
47f805 |
this preset will determine the optimal settings for that particular situation.
|
|
Packit |
47f805 |
While this approach works,
|
|
Packit |
47f805 |
it is not nearly as flexible as VBR,
|
|
Packit |
47f805 |
and usually will not attain the same level of quality as VBR at higher bitrates.
|
|
Packit |
47f805 |
.TP
|
|
Packit |
47f805 |
.B cbr
|
|
Packit |
47f805 |
If you use the ABR mode (read above) with a significant bitrate such as 80,
|
|
Packit |
47f805 |
96,
|
|
Packit |
47f805 |
112,
|
|
Packit |
47f805 |
128,
|
|
Packit |
47f805 |
160,
|
|
Packit |
47f805 |
192,
|
|
Packit |
47f805 |
224,
|
|
Packit |
47f805 |
256,
|
|
Packit |
47f805 |
320,
|
|
Packit |
47f805 |
you can use the
|
|
Packit |
47f805 |
.B \-\-preset cbr " kbps"
|
|
Packit |
47f805 |
option to force CBR mode encoding instead of the standard ABR mode.
|
|
Packit |
47f805 |
ABR does provide higher quality but CBR may be useful in situations such as when
|
|
Packit |
47f805 |
streaming an MP3 over the Internet may be important.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.SH EXAMPLES
|
|
Packit |
47f805 |
.LP
|
|
Packit |
47f805 |
Fixed bit rate jstereo 128kbs encoding:
|
|
Packit |
47f805 |
.IP
|
|
Packit |
47f805 |
.B lame \-b
|
|
Packit |
47f805 |
.I 128 sample.wav sample.mp3
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.LP
|
|
Packit |
47f805 |
Fixed bit rate jstereo 128 kbps encoding, highest quality:
|
|
Packit |
47f805 |
.IP
|
|
Packit |
47f805 |
.B lame \-q 0 \-b
|
|
Packit |
47f805 |
.I 128 sample.wav sample.mp3
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.LP
|
|
Packit |
47f805 |
To disable joint stereo encoding (slightly faster,
|
|
Packit |
47f805 |
but less quality at bitrates <= 128 kbps):
|
|
Packit |
47f805 |
.IP
|
|
Packit |
47f805 |
.B lame \-m
|
|
Packit |
47f805 |
.I s sample.wav sample.mp3
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.LP
|
|
Packit |
47f805 |
Variable bitrate (use \-V n to adjust quality/filesize):
|
|
Packit |
47f805 |
.IP
|
|
Packit |
47f805 |
.B lame \-V
|
|
Packit |
47f805 |
.I 2 sample.wav sample.mp3
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.LP
|
|
Packit |
47f805 |
Streaming mono 22.05 kHz raw pcm, 24 kbps output:
|
|
Packit |
47f805 |
.IP
|
|
Packit |
47f805 |
.B cat
|
|
Packit |
47f805 |
.I inputfile
|
|
Packit |
47f805 |
.B | lame \-r \-m
|
|
Packit |
47f805 |
.I m
|
|
Packit |
47f805 |
.B \-b
|
|
Packit |
47f805 |
.I 24
|
|
Packit |
47f805 |
.B \-s
|
|
Packit |
47f805 |
.I 22.05 \- \-
|
|
Packit |
47f805 |
.B >
|
|
Packit |
47f805 |
.I output
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.LP
|
|
Packit |
47f805 |
Streaming mono 44.1 kHz raw pcm,
|
|
Packit |
47f805 |
with downsampling to 22.05 kHz:
|
|
Packit |
47f805 |
.IP
|
|
Packit |
47f805 |
.B cat
|
|
Packit |
47f805 |
.I inputfile
|
|
Packit |
47f805 |
.B | lame \-r \-m
|
|
Packit |
47f805 |
.I m
|
|
Packit |
47f805 |
.B \-b
|
|
Packit |
47f805 |
.I 24
|
|
Packit |
47f805 |
.B \-\-resample
|
|
Packit |
47f805 |
.I 22.05 \- \-
|
|
Packit |
47f805 |
.B >
|
|
Packit |
47f805 |
.I output
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.LP
|
|
Packit |
47f805 |
Encode with the
|
|
Packit |
47f805 |
.B standard
|
|
Packit |
47f805 |
preset:
|
|
Packit |
47f805 |
.IP
|
|
Packit |
47f805 |
.B lame \-\-preset standard
|
|
Packit |
47f805 |
.I sample.wav sample.mp3
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
.SH BUGS
|
|
Packit |
47f805 |
.PP
|
|
Packit |
47f805 |
Probably there are some.
|
|
Packit |
47f805 |
.SH SEE ALSO
|
|
Packit |
47f805 |
.BR mpg123 (1) ,
|
|
Packit |
47f805 |
.BR madplay (1) ,
|
|
Packit |
47f805 |
.BR sox (1)
|
|
Packit |
47f805 |
.SH AUTHORS
|
|
Packit |
47f805 |
.nf
|
|
Packit |
47f805 |
LAME originally developed by Mike Cheng and now maintained by
|
|
Packit |
47f805 |
Mark Taylor, and the LAME team.
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
GPSYCHO psycho-acoustic model by Mark Taylor.
|
|
Packit |
47f805 |
(See http://www.mp3dev.org/).
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
mpglib by Michael Hipp
|
|
Packit |
47f805 |
|
|
Packit |
47f805 |
Manual page by William Schelter, Nils Faerber, Alexander Leidinger,
|
|
Packit |
47f805 |
and Rog\['e]rio Brito.
|
|
Packit |
47f805 |
.\" Local Variables:
|
|
Packit |
47f805 |
.\" mode: nroff
|
|
Packit |
47f805 |
.\" End:
|