{ "schemaVersion": 1, "contentVersion": "ca42e61ede0a24f789d7287a0001244ad22f4abf", "id": "docs/tools/software-encoders/qaac", "collection": "docs", "title": "qaac", "description": "qaac is a Windows command-line encoder that uses Apple's Core Audio libraries to produce AAC and ALAC; this page covers setup, good settings and the full option list.", "canonicalUrl": "https://encode.wiki/tools/software-encoders/qaac/", "apiUrl": "https://encode.wiki/api/v1/documents/docs/tools/software-encoders/qaac.json", "markdownUrl": "https://encode.wiki/api/v1/markdown/docs/tools/software-encoders/qaac.md", "status": "current", "tags": [ "audio", "aac" ], "license": "CC BY-SA 4.0", "dates": { "lastVerified": "2026-10-08T00:00:00.000Z" }, "authors": [], "sources": [ { "title": "qaac 3.07 README and release notice", "url": "https://github.com/nu774/qaac/blob/v3.07/README.md", "accessedAt": "2026-10-08T00:00:00.000Z" }, { "title": "qaac 3.07 option parser and help", "url": "https://github.com/nu774/qaac/blob/v3.07/options.cpp", "accessedAt": "2026-10-08T00:00:00.000Z" }, { "title": "qaac 3.07 initial option defaults", "url": "https://github.com/nu774/qaac/blob/v3.07/options.h", "accessedAt": "2026-10-08T00:00:00.000Z" }, { "title": "qaac installation instructions", "url": "https://github.com/nu774/qaac/wiki/Installation", "accessedAt": "2026-10-08T00:00:00.000Z" }, { "title": "qaac 3.07 release", "url": "https://github.com/nu774/qaac/releases/tag/v3.07", "accessedAt": "2026-10-08T00:00:00.000Z" }, { "title": "Doom9 thread quoting Hydrogenaudio TVBR bitrate measurements", "url": "https://forum.doom9.org/archive/index.php/t-182671.html", "accessedAt": "2026-10-08T00:00:00.000Z" } ], "headings": [ { "depth": 2, "text": "Install", "anchor": "install" }, { "depth": 2, "text": "Good settings", "anchor": "good-settings" }, { "depth": 2, "text": "Things that bite", "anchor": "things-that-bite" }, { "depth": 2, "text": "Full option reference", "anchor": "full-option-reference" }, { "depth": 3, "text": "Codec, rate, and container", "anchor": "codec-rate-and-container" }, { "depth": 3, "text": "PCM processing, sampling, and channels", "anchor": "pcm-processing-sampling-and-channels" }, { "depth": 3, "text": "Trimming and input interpretation", "anchor": "trimming-and-input-interpretation" }, { "depth": 3, "text": "Output, files, and reporting", "anchor": "output-files-and-reporting" }, { "depth": 3, "text": "Tags, artwork, and chapters", "anchor": "tags-artwork-and-chapters" } ], "sections": [ { "id": "_preamble", "title": "Page introduction", "depth": 0, "canonicalUrl": "https://encode.wiki/tools/software-encoders/qaac/", "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/_preamble.json", "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/_preamble.md", "checksum": "89599f9ca0c80799e89d5c2fe8d386fe17eb3e355710b7847bd5dfe5d942f25c", "bytes": 774 }, { "id": "install", "title": "Install", "depth": 2, "anchor": "install", "canonicalUrl": "https://encode.wiki/tools/software-encoders/qaac/#install", "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/install.json", "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/install.md", "checksum": "4902dfcb6a6f9f2856d317d9dbfef7ae65f2eaea45b6a6a715a962a1aa506d4b", "bytes": 1088 }, { "id": "good-settings", "title": "Good settings", "depth": 2, "anchor": "good-settings", "canonicalUrl": "https://encode.wiki/tools/software-encoders/qaac/#good-settings", "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/good-settings.json", "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/good-settings.md", "checksum": "138aa6830c708f013b6d09ff8a1341ec882eaf05eef19ea3d567297e159a028f", "bytes": 1190 }, { "id": "things-that-bite", "title": "Things that bite", "depth": 2, "anchor": "things-that-bite", "canonicalUrl": "https://encode.wiki/tools/software-encoders/qaac/#things-that-bite", "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/things-that-bite.json", "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/things-that-bite.md", "checksum": "53d416678a378435c1e71568720a8daafe403a05290bdd09e44f9580079dd30c", "bytes": 607 }, { "id": "full-option-reference", "title": "Full option reference", "depth": 2, "anchor": "full-option-reference", "canonicalUrl": "https://encode.wiki/tools/software-encoders/qaac/#full-option-reference", "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/full-option-reference.json", "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/full-option-reference.md", "checksum": "eeff4c45da9d40605ec17041dfd740ebd7532ebbcd6cabb92099528a964219c8", "bytes": 9286 }, { "id": "codec-rate-and-container", "title": "Codec, rate, and container", "depth": 3, "anchor": "codec-rate-and-container", "canonicalUrl": "https://encode.wiki/tools/software-encoders/qaac/#codec-rate-and-container", "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/codec-rate-and-container.json", "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/codec-rate-and-container.md", "checksum": "9f12664dad30c419c9c065cecf5821a6b1fe4126b3c9b099816164878d7edc66", "bytes": 2230 }, { "id": "pcm-processing-sampling-and-channels", "title": "PCM processing, sampling, and channels", "depth": 3, "anchor": "pcm-processing-sampling-and-channels", "canonicalUrl": "https://encode.wiki/tools/software-encoders/qaac/#pcm-processing-sampling-and-channels", "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/pcm-processing-sampling-and-channels.json", "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/pcm-processing-sampling-and-channels.md", "checksum": "291c3ab7670d8ed8a4dc9da2eb433b5532f3ba73513a265db292609aeb06c85d", "bytes": 2022 }, { "id": "trimming-and-input-interpretation", "title": "Trimming and input interpretation", "depth": 3, "anchor": "trimming-and-input-interpretation", "canonicalUrl": "https://encode.wiki/tools/software-encoders/qaac/#trimming-and-input-interpretation", "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/trimming-and-input-interpretation.json", "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/trimming-and-input-interpretation.md", "checksum": "d44b1af62aff5b830c49f96a54b8116eef8585723426c31a36b5220dfbfe014c", "bytes": 1208 }, { "id": "output-files-and-reporting", "title": "Output, files, and reporting", "depth": 3, "anchor": "output-files-and-reporting", "canonicalUrl": "https://encode.wiki/tools/software-encoders/qaac/#output-files-and-reporting", "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/output-files-and-reporting.json", "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/output-files-and-reporting.md", "checksum": "65a44d3bed5d34505a2a850035be5ef27eb33892b9fab470f94761ed6122e0cb", "bytes": 1891 }, { "id": "tags-artwork-and-chapters", "title": "Tags, artwork, and chapters", "depth": 3, "anchor": "tags-artwork-and-chapters", "canonicalUrl": "https://encode.wiki/tools/software-encoders/qaac/#tags-artwork-and-chapters", "apiUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/tags-artwork-and-chapters.json", "markdownUrl": "https://encode.wiki/api/v1/sections/docs/tools/software-encoders/qaac/tags-artwork-and-chapters.md", "checksum": "9383b0af7e214e1de111f318cf5be4e7e825318393ee746c61ed54f1e2f9da4d", "bytes": 1597 } ], "outboundReferences": [ "/codecs/audio/aac/", "https://forum.doom9.org/archive/index.php/t-182671.html", "https://github.com/nu774/qaac", "https://github.com/nu774/qaac/blob/v3.07/options.cpp", "https://github.com/nu774/qaac/releases", "https://github.com/nu774/qaac/releases/tag/v3.07" ], "checksum": "a322c7632ce83bdebc3ba14278563e3145555e21efe762af230f8b1e4a29508f", "contentFormat": "markdown", "markdown": "> **Repository:** [nu774/qaac](https://github.com/nu774/qaac). CLI QuickTime AAC/ALAC encoder. Latest release: [v3.07](https://github.com/nu774/qaac/releases/tag/v3.07), Sep 10, 2026. Last commit: Sep 10, 2026. Stars: 999.\n\n`qaac` is a command-line frontend to Apple's Core Audio [AAC encoder](/codecs/audio/aac/). Apple's encoder is generally regarded as the best AAC encoder available, which is why people use qaac on Windows: it gives you Apple's AAC-LC, HE-AAC and ALAC from a normal command line, without iTunes.\n\nIt is Windows-only. The Apple encoder itself is not bundled and not redistributable, so it has to come from an Apple installer. On macOS use `afconvert` (or FFmpeg's `aac_at`) instead. On Linux the repository only builds `refalac`, the ALAC-only sibling.\n\n## Install\n\n1. Download `qaac_3.07.zip` from the [GitHub releases](https://github.com/nu774/qaac/releases). It contains 32-bit (`x86`) and 64-bit (`x64`) builds; use `qaac64.exe` on 64-bit Windows.\n2. Get Apple Application Support (it contains `CoreAudioToolbox.dll`). Download the iTunes installer from Apple's \"other versions\" link, **not** the Microsoft Store version, which does not work. You do not have to install iTunes: unpack the installer with 7-Zip and install the `AppleApplicationSupport64.msi` inside, or just install iTunes.\n3. Optionally add `libFLAC.dll`, `wavpackdll.dll` or `libsndfile` DLLs next to `qaac64.exe` so qaac can read FLAC, WavPack and others directly. Without them, pipe the input from FFmpeg.\n\nRun `qaac64 --check` to see the loaded Apple library versions and `qaac64 --formats` to list the rate and channel combinations your installation supports.\n\n> **Caution.**\n>\n> CoreAudioToolbox 7.9.8 and newer (through at least 7.10.9.0) can put glitches in AAC **CBR** output, according to the qaac README. Avoid `--cbr`; the problem was only found in CBR mode.\n## Good settings\n\nTrue VBR (`--tvbr`, quality 0–127) is the normal choice for music. The resulting bitrate depends on the material. Typical stereo music averages, measured on Hydrogenaudio and quoted on [Doom9](https://forum.doom9.org/archive/index.php/t-182671.html):\n\n| --tvbr | Approx. kbit/s (stereo) |\n| --- | --- |\n| 127 | 320 |\n| 109 | 255 |\n| 91 | 195 |\n| 82 | 165 |\n| 73 | 150 |\n| 64 | 135 |\n\nThe default for AAC-LC is `--tvbr 90`. Apple's encoder snaps the value to 15 steps (0, 9, 18 … 91, 100, 109, 118, 127), so 90 and the often-quoted 91 encode identically; step up to 100 or 109 for more margin. 127 only makes sense if you want the largest file the encoder can produce. Multichannel sources scale up a lot (a 5.1 file at `--tvbr 91` ran at roughly 450 kbit/s in the same thread).\n\n```sh\nqaac64 --tvbr 91 -o output.m4a input.wav\nffmpeg -i input.flac -f wav - | qaac64 --tvbr 91 -o output.m4a -\n```\n\n`--quality` (0–2, default 2) is encoder effort, not an audio-quality setting; leave it at 2.\n\nHE-AAC has no TVBR; use constrained VBR with a bitrate:\n\n```sh\nqaac64 --he --cvbr 64 -o he-aac.m4a input.wav\n```\n\nApple ALAC (lossless) is `qaac64 -A -o output.m4a input.wav`.\n\n## Things that bite\n\n- Only one rate mode (`--tvbr`, `--abr`, `--cvbr`, `--cbr`) may be given.\n- qaac keeps the input sample rate when it can (`-r keep`). Pass `-r 48000`, or `-r auto` to let the encoder choose.\n- Gapless playback metadata is written in iTunes style by default. `--no-smart-padding` disables the boundary extrapolation that makes gapless transitions smooth; it exists as a workaround for a Core Audio HE-AAC bug, and can break gapless playback.\n- `--drc` and `--gain` change the audio samples; they do not write AAC metadata.\n- `-o -` writes to stdout only for ADTS or WAV output, not M4A.\n\n## Full option reference\n\nEvery qaac 3.07 option, with defaults from the [option parser](https://github.com/nu774/qaac/blob/v3.07/options.cpp). Which sample rates, bitrates and HE-AAC modes are accepted depends on the installed Apple encoder; `--formats` lists them. The `--fast` switch in the source belongs to `refalac`, not qaac.\n\n### Codec, rate, and container\n\nPick one of `-V`, `-a`, `-v` or `-c`; qaac rejects more than one.\n\n| Parameter | Default | Values / units | Effect |\n| --- | --- | --- | --- |\n| `-V`, `--tvbr N` | `90` (the default mode for AAC-LC) | `0`–`127` | True VBR quality. Apple uses 15 steps (0, 9, 18, 27, 36, 45, 54, 63, 73, 82, 91, 100, 109, 118, 127) and maps other values onto them, so `90` encodes as q91. Not available with `--he`. |\n| `-a`, `--abr N` | Off | kbit/s; `0` = highest available | Average bitrate. |\n| `-v`, `--cvbr N` | Off; `0` with `--he` | kbit/s; `0` = highest available | Constrained VBR. The default mode for HE-AAC. |\n| `-c`, `--cbr N` | Off | kbit/s; `0` = highest available | Constant bitrate. |\n| `--he` | Off (AAC-LC) | Flag | HE-AAC (SBR). TVBR is unavailable, so the default becomes `-v 0`. |\n| `-q`, `--quality N` | `2` | `0`–`2` | Encoder effort; 2 is slowest and best. Separate from the TVBR quality. |\n| `-A`, `--alac` | Off | Flag | Encode ALAC (lossless) instead of AAC. |\n| `-D`, `--decode` | Off | Flag | Decode to WAV instead of encoding. |\n| `--play` | Off | Flag | Decode and play to a WaveOut device. |\n| `--peak` | Off | Flag | Print the peak level after any DSP options; writes no file. Can't be combined with an encoding mode or `-D`. |\n| `--adts` | Off (M4A) | Flag | Write raw ADTS instead of M4A. AAC only. |\n| `--caf` | Off | Flag | Write CAF instead of M4A, WAV or ADTS. Not with `--adts`. |\n| `--no-optimize` | Off | Flag | Accepted, but has no effect in 3.x. |\n| `--no-smart-padding` | Off | Flag | Disable the extrapolation at the start and end that gives smooth gapless transitions. Output then matches iTunes bit for bit, but gapless playback can suffer, especially with HE-AAC. Can't be combined with `--num-priming`. |\n| `--gapless-mode N` | `0` | `0` iTunSMPB, `1` ISO (`elst` + `sbgp` + `sgpd`), `2` both | How encoder delay and padding are signalled. |\n| `--num-priming N` | `2112` | `0`–`2112` samples | Experimental: change the AAC-LC encoder delay (priming). LC only. |\n| `--no-delay` | Off | Flag | Same as `--num-priming 0`: prepends 960 samples of silence and trims the first three AAC frames so the output has no encoder delay. Intended for A/V sync in video. |\n\n### PCM processing, sampling, and channels\n\n| Parameter | Default | Values / units | Effect |\n| --- | --- | --- | --- |\n| `-r`, `--rate VALUE` | `keep` | `keep`, `auto` or Hz | Output sample rate: keep the input rate where the encoder supports it, let the encoder choose, or resample to the given rate. |\n| `--lowpass N` | `0` (Apple default) | Hz | Use a lower cut-off than Apple's default. |\n| `--native-resampler[=MODE,QUALITY]` | Off | `line`, `norm` or `bats`, then quality `0`–`127` | Use Core Audio's resampler instead of libsoxr. Without arguments it uses `bats` (best), quality 0. Arguments must follow `=`, e.g. `--native-resampler=norm,96`. |\n| `--builtin-resampler` | Off | Flag | Use qaac's built-in polyphase resampler instead of libsoxr. It is used anyway when libsoxr is missing. |\n| `-b`, `--bits-per-sample N` | From input | `2`–`32` | Output bit depth, WAV and ALAC only. |\n| `--no-dither` | Off | Flag | Don't dither when reducing bit depth. |\n| `--gain N` | `0` | dB | Change the level; use a negative value to avoid clipping after DSP. |\n| `-N`, `--normalize` | Off | Flag | Peak-normalize in two passes. Piped input is spooled to a temporary file, which can be huge. |\n| `--drc SPEC` | Off | `threshold:ratio:knee:attack:release[:statfile]` | Dynamic range compressor applied to the samples: threshold below 0 dBFS, ratio above 1, knee in dB, attack and release in ms. Repeatable. |\n| `--limiter` | Off | Flag | Soft-clip peaks that reach about 0 dBFS. |\n| `--matrix-preset NAME` | None | Preset name | Remix channels with a user-defined matrix preset. |\n| `--matrix-file FILE` | None | Filename | Remix channels with coefficients from a file. |\n| `--no-matrix-normalize` | Off | Flag | Don't normalize the matrix coefficients. |\n| `--chanmap LIST` | Input order | 1-based list, e.g. `2,1` | Reorder input channels; `2,1` swaps left and right. |\n| `--chanmask N` | From input | Decimal or `0x` hex; `0` ignores the input mask | Override the input channel mask (speaker layout). Doesn't remix. |\n\n### Trimming and input interpretation\n\n| Parameter | Default | Values / units | Effect |\n| --- | --- | --- | --- |\n| `--start TIME` | Start of input | `[[hh:]mm:]ss[.sss]`, `s` (samples) or `f` (cue frames) | Start point. A negative value prepends silence instead. |\n| `--end TIME` | End of input | As `--start` | End point (exclusive). |\n| `--delay TIME` | None | As `--start` | `--start` with the sign reversed: a positive value prepends silence. Not with `--start`. |\n| `-R`, `--raw` | Off | Flag | Read headerless PCM described by the `--raw-*` options. |\n| `--raw-channels N` | `2` | `1`–`8` | Raw channel count. |\n| `--raw-rate N` | `44100` | Hz | Raw sample rate. |\n| `--raw-format SPEC` | `S16L` | `S`, `U` or `F`, bit width, optional `L`/`B` | Raw sample format, case-insensitive (`S24L`, `F32L`). `F` needs 32 or 64 bits. |\n| `-i`, `--ignorelength` | Off | Flag | Treat the input as WAV and ignore its data-chunk length, for piped WAV. Not with `--raw`. |\n| `--concat` | Off | Flag | Encode all inputs into one file; needs `-o`. |\n| `--cue-tracks LIST` | All tracks | `n[-n][,n[-n]]…`, `0`–`99` | Tracks to extract from a cue sheet; `2-99` skips track 1 and the hidden pregap. |\n\n### Output, files, and reporting\n\n| Parameter | Default | Values / units | Effect |\n| --- | --- | --- | --- |\n| `-o FILE` | Input name, new extension | Filename; `-` for stdout (ADTS or WAV output) | Output file, for a single input or with `--concat`. |\n| `-d DIR` | Current directory | Directory | Output directory. |\n| `--fname-from-tag` | Off | Flag | Name output files from the input tags, using `--fname-format`. |\n| `--fname-format TEXT` | `${tracknumber}${title& }${title}` | Template | Output filename template for `--fname-from-tag`. |\n| `--tmpdir DIR` | `%TMP%` | Directory | Directory for temporary files. |\n| `--sort-args` | Off | Flag | Sort input filenames before processing. |\n| `--text-codepage N` | `0` (auto-detect) | Code page, e.g. `65001` UTF-8, `1252` Latin-1 | Encoding of cue sheets, chapter and lyrics files; set it when auto-detection writes garbled tags. |\n| `--threading` | Off | Flag | Run decoding and DSP on a separate thread from the encoder (AAC and ALAC). |\n| `-n`, `--nice` | Off | Flag | Run at lower process priority. |\n| `-s`, `--silent` | Off | Flag | No console output. |\n| `--verbose` | Off | Flag | More detailed console output. |\n| `-S`, `--stat` | Off | Flag | Save per-frame bitrate statistics to `.stat.txt`. |\n| `--log FILE` | None | Filename | Also write messages to a file. |\n| `-h`, `--help` | — | Flag | Print help. |\n| `--check` | — | Flag | Print the versions of the loaded Apple and helper libraries, then exit. |\n| `--formats` | — | Flag | List the AAC formats, sample rates and bitrates your Apple encoder supports, then exit. |\n| `--exec COMMAND ARG...` | Off | Program and arguments; must come last | Decode each track and pipe it as WAV (or CAF with `--caf`, which also carries tags) to a program, e.g. `--exec ffmpeg -i - -c:a libopus {}.opus`. `{}` becomes the output name without extension. No shell is involved. |\n\n### Tags, artwork, and chapters\n\nTags from the input are copied; these options set or override them. The same values go to every file in one invocation.\n\n| Parameter | Default | Values / syntax | Effect |\n| --- | --- | --- | --- |\n| `--title TEXT` | — | Text | Title. |\n| `--artist TEXT` | — | Text | Artist. |\n| `--band TEXT` | — | Text | Album artist. |\n| `--album TEXT` | — | Text | Album. |\n| `--grouping TEXT` | — | Text | Grouping. |\n| `--composer TEXT` | — | Text | Composer. |\n| `--comment TEXT` | — | Text | Comment. |\n| `--genre TEXT` | — | Text | Genre. |\n| `--date TEXT` | — | Text | Date. |\n| `--track N[/TOTAL]` | — | `N` or `N/TOTAL` | Track number. |\n| `--disk N[/TOTAL]` | — | `N` or `N/TOTAL` | Disc number. |\n| `--compilation[=N]` | Off | `0`/`1`; the bare flag means `1` | iTunes compilation flag. |\n| `--lyrics FILE` | — | Filename | Lyrics from a text file. |\n| `--artwork FILE` | — | Image file; repeatable | Attach cover art. |\n| `--artwork-size N` | `0` (no limit) | Pixels | Downscale attached or copied artwork whose width or height exceeds this. |\n| `--copy-artwork` | Off | Flag | Copy the front cover from the input. Ignored when `--artwork` is given. |\n| `--chapter FILE` | — | Filename | Chapters from a file. |\n| `--tag FCC:VALUE` | — | `FCC:VALUE` | Set an iTunes atom by four-character code; a three-character code gets the `©` prefix. |\n| `--tag-from-file FCC:FILE` | — | `FCC:FILE` | As `--tag`, with the value read from a file. |\n| `--long-tag NAME:VALUE` | — | `NAME:VALUE` | Custom iTunes (`----`) tag, stored as UTF-8. |\n" }