-
Notifications
You must be signed in to change notification settings - Fork 42
Command Line Options
nu774 edited this page Jan 5, 2014
·
13 revisions
qaac 2.32
Usage: qaac [options] infiles....
"-" as infile means stdin.
On ADTS/WAV output mode, "-" as outfile means stdout.
Main options:
--formats Show available AAC formats and exit
-a, --abr <bitrate> AAC ABR mode / bitrate
-V, --tvbr <n> AAC True VBR mode / quality [0-127]
-v, --cvbr <bitrate> AAC Constrained VBR mode / bitrate
-c, --cbr <bitrate> AAC CBR mode / bitrate
For -a, -v, -c, "0" as bitrate means "highest".
Highest bitrate available is automatically chosen.
For LC, default is -V90
For HE, default is -v0
--he HE AAC mode (TVBR is not available)
-q, --quality <n> AAC encoding Quality [0-2]
--adts ADTS output (AAC only)
-A, --alac ALAC encoding mode
-d <dirname> Output directory. Default is current working dir.
--check Show library versions and exit.
-D, --decode Decode to a WAV file.
--caf Output to CAF file instead of M4A/WAV/AAC.
--play Decode to a WaveOut device (playback).
-r, --rate <keep|auto|n>
keep: output sampling rate will be same as input
if possible.
auto: output sampling rate will be automatically
chosen by encoder.
n: desired output sampling rate in Hz.
--lowpass <number> Specify lowpass filter cut-off frequency in Hz.
Use this when you want lower cut-off than
Apple default.
-b, --bits-per-sample <n>
Bits per sample of output (for WAV/ALAC only)
--no-dither Turn off dither when quantizing to lower bit depth.
--peak Scan + print peak (don't generate output file).
Cannot be used with encoding mode or -D.
When DSP options are set, peak is computed
after all DSP filters have been applied.
--gain <f> Adjust gain by f dB.
Use negative value to decrese gain, when you want to
avoid clipping introduced by DSP.
-N, --normalize Normalize (works in two pass. can generate HUGE
tempfile for large piped input)
--drc <thresh:ratio:knee:attack:release>
Dynamic range compression.
Loud parts over threshold are attenuated by ratio.
thresh: threshold (in dBFS, < 0.0)
ratio: compression ratio (> 1.0)
knee: knee width (in dB, >= 0.0)
attack: attack time (in millis, >= 0.0)
release: release time (in millis, >= 0.0)
--delay <[[hh:]mm:]ss[.ss..]|ns>
Specify delay either by time or number of samples.
When positive value is given, silence is prepended
at the begining to achieve specified amount of delay.
When negative value is given, specified length is
dropped from the beginning.
Example:
--delay -2112s : trim 2112 samples at beginning
--delay 1.234 : prepend 1.234 seconds silence
--no-delay Compensate encoder delay by prepending 960 samples
of scilence, then trimming 3 AAC frames from
the beginning (and also tweak iTunSMPB).
This option is mainly intended for resolving
A/V sync issue of video.
--gapless-mode <n> Encoder delay signaling for gapless playback.
0: iTunSMPB (default)
1: ISO standard (elst + sbgp + sgpd)
2: Both
--matrix-preset <name> Specify user defined preset for matrix mixer.
--matrix-file <file> Matrix file for remix.
--no-matrix-normalize Don't automatically normalize(scale) matrix
coefficients for the matrix mixer.
--chanmap <n1,n2...> Rearrange input channels to the specified order.
Example:
--chanmap 2,1 -> swap L and R.
--chanmap 2,3,1 -> C+L+R -> L+R+C.
--chanmask <n> Force input channel mask(bitmap).
Either decimal or hex number with 0x prefix
can be used.
When 0 is given, qaac works as if no channel mask is
present in the source and picks default layout.
--no-optimize Don't optimize MP4 container after encoding.
--tmpdir <dirname> Specify temporary directory. Default is %TMP%
-s, --silent Suppress console messages.
--verbose More verbose console messages.
-i, --ignorelength Assume WAV input and ignore the data chunk length.
--threading Enable multi-threading.
-n, --nice Give lower process priority.
--sort-args Sort filenames given by command line arguments.
--text-codepage <n> Specify text code page of cuesheet/chapter/lyrics.
Example: 1252 for Latin-1, 65001 for UTF-8.
Use this when bogus values are written into tags due to automatic encoding detection failure.
-S, --stat Save bitrate statistics into file.
--log <filename> Output message to file.
Option for output filename generation:
--fname-from-tag Generate filename based on metadata of input.
By default, output filename will be the same as input
(only different by the file extension).
Name generation can be tweaked by --fname-format.
--fname-format <string> Format string for output filename.
Option for single output:
-o <filename> Specify output filename
--concat Encodes whole inputs into a single file.
Requires output filename (with -o)
Option for cuesheet input only:
--cue-tracks <n[-n][,n[-n]]*>
Limit extraction to specified tracks.
Tracks can be specified with comma separated numbers.
Hyphen can be used to denote range of numbers.
Tracks non-existent in the cue are just ignored.
Numbers must be in the range 0-99.
Example:
--cue-tracks 1-3,6-9,11
-> equivalent to --cue-tracks 1,2,3,6,7,8,9,11
--cue-tracks 2-99
-> can be used to skip first track (and HTOA)
Options for Raw PCM input only:
-R, --raw Raw PCM input.
--raw-channels <n> Number of channels, default 2.
--raw-rate <n> Sample rate, default 44100.
--raw-format <str> Sample format, default S16L.
Sample format spec:
1st char: S(igned) | U(nsigned) | F(loat)
2nd part: Bitwidth
Last part: L(ittle Endian) | B(ig Endian)
Last part can be omitted, L is assumed by default.
Cases are ignored. u16b is OK.
Options for CoreAudio sample rate converter:
--native-resampler[=line|norm|bats,n]
Arguments are optional.
Without argument, codec default SRC is used.
With argument, dedicated AudioConverter is used for
sample rate conversion.
'--native-resampler' and arguments must be delimited
by a '=' (space is not usable here).
Arguments must be delimited by a ','(comma).
First argument is sample rate converter complexity,
and one of line, norm, bats.
line: linear (worst, don't use this)
norm: normal
bats: mastering (best, but quite sloooow)
Second argument is sample rate converter quality,
which is an integer between 0-127.
Example:
--native-resampler
--native-resampler=norm,96
Tagging options:
(same value is set to all files, so use with care for multiple files)
--title <string>
--artist <string>
--band <string> This means "Album Artist".
--album <string>
--grouping <string>
--composer <string>
--comment <string>
--genre <string>
--date <string>
--track <number[/total]>
--disk <number[/total]>
--compilation[=0|1]
By default, iTunes compilation flag is not set.
--compilation or --compilation=1 sets flag on.
--compilation=0 is same as default.
--lyrics <filename>
--artwork <filename>
--artwork-size <n> Specify maximum width or height of artwork in pixels.
If specified artwork (with --artwork) is larger than
this, artwork is automatically resized.
--chapter <filename>
Set chapter from file.
--tag <fcc>:<value>
Set iTunes pre-defined tag with fourcc key
and value.
1) When key starts with U+00A9 (copyright sign),
you can use 3 chars starting from the second char
instead.
2) Some known tags having type other than UTF-8 string
are taken care of. Others are just stored as UTF-8
string.
--long-tag <key>:<value>
Set long tag (iTunes custom metadata) with
arbitrary key/value pair. Value is always stored as
UTF8 string.