v1.7.1

What's New

• Fixed AIFF ID3v2 tag preservation — artist, genre, album, key, and other tags are now preserved during gain adjustment
• Fixed WAV BWF metadata preservation — time_reference, umid, and other Broadcast Wave Format metadata are now retained

Installation

Platform	Command
macOS (Homebrew)	brew install M-Igashi/tap/headroom
Windows (Scoop)	scoop bucket add headroom https://github.com/M-Igashi/scoop-bucket && scoop install headroom
Windows (winget)	winget install M-Igashi.headroom
Cargo	cargo install headroom (ffmpeg must be installed separately)

Package managers (Homebrew, Scoop, winget) install ffmpeg automatically. mp3rgain is built-in — no separate installation needed.

Checksums

See headroom-v1.7.1-checksums.txt for SHA256 checksums of all binaries.

Full Changelog: v1.7.0...v1.7.1

v1.7.0

What's Changed

Added lossless AAC/M4A gain adjustment support via mp3rgain crate v2.0.

New Features

• AAC/M4A lossless gain adjustment: AAC/M4A files with ≥1.5dB headroom are now processed losslessly using bitstream-level gain adjustment, matching the existing MP3 lossless gain behavior
• Previously, all AAC/M4A files required lossy re-encoding for gain adjustment

Changes

• Updated mp3rgain dependency from v1.6 to v2.0 (with aac feature)
• Added AacLossless gain method alongside existing Mp3Lossless
• Added apply_gain_aac_native() processor using mp3rgain::aac::apply_aac_gain()
• Renamed MP3_GAIN_STEP constant to GAIN_STEP (shared between MP3 and AAC)

---

Installation

Platform	Command
macOS (Homebrew)	brew install M-Igashi/tap/headroom
Windows (Scoop)	scoop bucket add headroom https://github.com/M-Igashi/scoop-bucket && scoop install headroom
Windows (winget)	winget install M-Igashi.headroom
Cargo	cargo install headroom

v1.6.0

What's Changed

Updated mp3rgain CLI invocation to match v0.3.0 flag-based interface.

Changes

• Updated mp3rgain command from subcommand style (mp3rgain apply -g <steps> <file>) to flag style (mp3rgain -g <steps> <file>)
• Requires mp3rgain v0.3.0 or later

Compatibility

This release requires mp3rgain v0.3.0 which uses mp3gain-compatible flags instead of subcommands.

---

Installation

brew tap M-Igashi/tap
brew install headroom

ffmpeg and mp3rgain are installed automatically as dependencies.

v1.5.1

What's Changed

Updated mp3rgain CLI invocation to match v0.3.0 flag-based interface.

Changes

• Updated mp3rgain command from subcommand style (mp3rgain apply -g <steps> <file>) to flag style (mp3rgain -g <steps> <file>)
• Requires mp3rgain v0.3.0 or later

Compatibility

This release requires mp3rgain v0.3.0 which uses mp3gain-compatible flags instead of subcommands.

---

Installation

brew tap M-Igashi/tap
brew install headroom

ffmpeg and mp3rgain are installed automatically as dependencies.

v1.5.0

What's Changed

Updated mp3rgain CLI invocation to match v0.3.0 flag-based interface.

Changes

• Updated mp3rgain command from subcommand style (mp3rgain apply -g <steps> <file>) to flag style (mp3rgain -g <steps> <file>)
• Requires mp3rgain v0.3.0 or later

Compatibility

This release requires mp3rgain v0.3.0 which uses mp3gain-compatible flags instead of subcommands.

---

Installation

brew tap M-Igashi/tap
brew install headroom

ffmpeg and mp3rgain are installed automatically as dependencies.

v1.4.3

What's Changed

Updated mp3rgain CLI invocation to match v0.3.0 flag-based interface.

Changes

• Updated mp3rgain command from subcommand style (mp3rgain apply -g <steps> <file>) to flag style (mp3rgain -g <steps> <file>)
• Requires mp3rgain v0.3.0 or later

Compatibility

This release requires mp3rgain v0.3.0 which uses mp3gain-compatible flags instead of subcommands.

---

Installation

brew tap M-Igashi/tap
brew install headroom

ffmpeg and mp3rgain are installed automatically as dependencies.

v1.4.2

What's Changed

Updated mp3rgain CLI invocation to match v0.3.0 flag-based interface.

Changes

• Updated mp3rgain command from subcommand style (mp3rgain apply -g <steps> <file>) to flag style (mp3rgain -g <steps> <file>)
• Requires mp3rgain v0.3.0 or later

Compatibility

This release requires mp3rgain v0.3.0 which uses mp3gain-compatible flags instead of subcommands.

---

Installation

brew tap M-Igashi/tap
brew install headroom

ffmpeg and mp3rgain are installed automatically as dependencies.

v1.4.1

What's Changed

Updated mp3rgain CLI invocation to match v0.3.0 flag-based interface.

Changes

• Updated mp3rgain command from subcommand style (mp3rgain apply -g <steps> <file>) to flag style (mp3rgain -g <steps> <file>)
• Requires mp3rgain v0.3.0 or later

Compatibility

This release requires mp3rgain v0.3.0 which uses mp3gain-compatible flags instead of subcommands.

---

Installation

brew tap M-Igashi/tap
brew install headroom

ffmpeg and mp3rgain are installed automatically as dependencies.

v1.4.0

What's Changed

Updated mp3rgain CLI invocation to match v0.3.0 flag-based interface.

Changes

• Updated mp3rgain command from subcommand style (mp3rgain apply -g <steps> <file>) to flag style (mp3rgain -g <steps> <file>)
• Requires mp3rgain v0.3.0 or later

Compatibility

This release requires mp3rgain v0.3.0 which uses mp3gain-compatible flags instead of subcommands.

---

Installation

brew tap M-Igashi/tap
brew install headroom

ffmpeg and mp3rgain are installed automatically as dependencies.

v1.3.0

What's Changed

Updated mp3rgain CLI invocation to match v0.3.0 flag-based interface.

Changes

• Updated mp3rgain command from subcommand style (mp3rgain apply -g <steps> <file>) to flag style (mp3rgain -g <steps> <file>)
• Requires mp3rgain v0.3.0 or later

Compatibility

This release requires mp3rgain v0.3.0 which uses mp3gain-compatible flags instead of subcommands.

---

Installation

brew tap M-Igashi/tap
brew install headroom

ffmpeg and mp3rgain are installed automatically as dependencies.