mp3rgain：无损 MP3 音量调整工具

项目简介

mp3rgain 是一个用 Rust 编写的 mp3gain / aacgain 现代替代品，可以在不重新编码的前提下改变 MP3 与 AAC 文件的音量。它改写每一帧中记录的 global_gain 字段——mp3gain、aacgain 修改的也是这个字段——因此音频不会被解码后再压缩，不会损失音质。除了命令行工具 mp3rgain，项目还提供桌面图形界面 mp3rgui。

主要功能

• 无损调整：只改变逐帧的 global_gain，支持 MP3、M4A/MP4 中的 AAC（包括视频 MP4 的音轨）以及裸 ADTS .aac。
• 可撤销：-u 根据撤销标签恢复原始增益；如果某帧的增益会超出 0..255 范围，它会被钳制，无法精确还原，并会给出警告。
• ReplayGain：默认使用与 mp3gain 数值一致的 ReplayGain 1.0；--rg2（ReplayGain 2.0，-18 LUFS）与 --r128（EBU R128，-23 LUFS）基于 BS.1770 响度；--tags-only 只写标签、不改动音频。
• 兼容 mp3gain：沿用 mp3gain 的参数、TSV 输出与 MP3GAIN_UNDO 标签，围绕 mp3gain 搭建的脚本与工具可以继续使用。
• 面向整库处理：递归扫描（-R）、每文件夹或每发行版一张专辑、并行处理、JSON 与 TSV 输出。
• 单一二进制：无需安装运行时或编解码器，覆盖 macOS（universal）、Linux、Windows，各有 x86_64 与 ARM64 版本。
• GUI：mp3rgui 支持拖放，提供曲目与专辑分析、目标音量、手动与分声道增益、撤销、已存标签的查看与删除、比特率与 CBR/VBR 显示、削波防止等功能。

安装与使用

命令行工具（节选）：

brew install M-Igashi/tap/mp3rgain   # macOS
winget install M-Igashi.mp3rgain     # Windows
cargo install mp3rgain               # Rust 1.85+

图形界面方面，Windows 可直接下载 mp3rgui-windows-setup.exe 安装包；macOS 使用 brew install --cask M-Igashi/tap/mp3rgui；Debian/Ubuntu 可添加项目自带的 apt 仓库后安装 mp3rgain 或 mp3rgui。

常用命令：

mp3rgain song.mp3                     # 仅分析，打印建议增益
mp3rgain -r song.mp3                  # 应用曲目增益
mp3rgain -a *.mp3                     # 把给出的文件视为一张专辑，应用专辑增益
mp3rgain -a --album-by=tag -R /music  # 整库按标签分专辑
mp3rgain -r --tags-only *.mp3         # 只写 ReplayGain 标签
mp3rgain -g 2 song.mp3                # 手动增益：+2 步 = +3.01 dB
mp3rgain -u song.mp3                  # 撤销

-a 单独使用时会把所有文件合并成一张专辑，与 mp3gain -a 的行为一致；要整库分专辑，可用 --album-by=tag、--album-depth 2 或 --album-by=dir。完整参数见 CLI 文档。

注意事项

• 格式支持：MP3（MPEG-1/2/2.5 Layer III）、M4A/MP4 中的 AAC-LC、裸 ADTS AAC-LC；HE-AAC、ALAC 与受 DRM 保护的 M4P 会被跳过并给出提示；FLAC、Opus、Ogg、WAV 不支持。格式按文件内容而非扩展名判断。
• 爆音问题：用 2.8.0 至 3.11.1 版本处理过、播放出现爆音的 AAC 文件，需要先用旧版本执行 mp3rgain -u 撤销，再升级并重新应用增益；直接用 3.12.0 及以上版本撤销会让情况更糟。
• 与 mp3gain 的默认差异：mp3rgain 把 REPLAYGAIN_* 写入 ID3v2（播放器读取的位置），撤销数据放在 APEv2（mp3gain 读取的位置），-s a 可完全按 mp3gain 的方式全部写入 APEv2；它默认重新分析每个文件，而 mp3gain 复用已存值，-s R 可恢复 mp3gain 的行为。
• GUI 差异：mp3rgui 默认按文件夹分专辑，并默认开启削波防止与时间戳保留；它没有 tags-only 与 true-peak 选项，这两项请使用命令行。
• Windows 二进制与安装包未做代码签名；macOS 的 GUI 应用与 DMG 已签名并公证，命令行二进制未签名。

本作品整理自 GitHub 开源项目 M-Igashi/mp3rgain，原作者 @M-Igashi，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。