v1.10.1
Highlights
- mp3rgain 2.6.1: Upgrade to the stable
symphonia 0.6.0release (previously0.6.0-alpha.2). No public API changes; lossless MP3/AAC gain behavior is identical.
Other Changes
- ci: bump actions/dependency-review-action from 4.9.0 to 5.0.0 (#36)
Highlights
- Uniform True Peak ceiling at -0.5 dBTP, with full per-run tuning. AES TD1008's bitrate-dependent ceiling describes the limiter threshold prior to lossy encoding (§7B Sources of Peak Overshoot — Codecs). headroom processes already-encoded delivery files, where there is no further codec stage downstream to absorb additional overshoot, so the same -0.5 dBTP ceiling — the most aggressive value TD1008 sanctions for any limiter in the chain — is now applied uniformly to every file. Low-bitrate lossy files gain +0.5 dB of loudness for free; lossless and ≥256 kbps lossy behaviour is unchanged. Resolves #34.
- New
--tp-target <DB>flag. Override the uniform target with any custom value, e.g.--tp-target -1.0for the Spotify / Apple Music / YouTube delivery max, or--tp-target -2.0for a conservative master that leaves headroom for player-side SRC / Hilbert downmix. - New
--tp-split-bitrateflag. Opt back into the legacy bitrate-dependent split (-0.5 dBTP for ≥256 kbps, -1.0 dBTP for <256 kbps). Mirrors TD1008's pre-encode interpretation for users who prefer it. - Native-lossless threshold scales with the chosen target. The True Peak below which an MP3/AAC file qualifies for in-place global_gain modification is now
target − 1.5 dBrather than the hardcoded -2.0 / -2.5 dBTP used through v1.9.x. - mp3rgain bumped to v2.5.0. Brings a fix for temp-file collisions when applying gain in parallel (mp3rgain@4e9b0b3) — relevant because headroom applies gain across files in parallel via rayon. Also picks up faster AAC apply / ReplayGain analysis pipelines.
Documentation
- New docs/true-peak-ceiling.md walks through the TD1008 reading with §-level citations, explains the pre-encode vs delivery distinction, and lists preset flag combinations for common targets (Spotify / R128 / TD1008 §4 / TD1008 §7B).
- README §True Peak Ceiling rewritten end-to-end with the new flag table and migration note.
Migration
Users who relied on the v1.9.x bitrate-dependent split can restore it exactly with --tp-split-bitrate. Users who want to match streaming-platform delivery max can use --tp-target -1.0.