mp3rgain のインストール方法
更新 · mp3rgain v3.16.2
コマンドライン版 (mp3rgain) とデスクトップアプリ (mp3rgui) の入手方法、アンインストール方法、動作確認の手順です。配布しているビルドは、macOS（ユニバーサルバイナリ）、Linux、Windows の x86_64 と ARM64 に対応しています。
Windows: インストーラーだけ欲しい方へ
Windows でデスクトップアプリを使うなら、ターミナルは不要です。インストーラーをダウンロードして実行してください。スタートメニューへの登録とアンインストーラーが付き、x64 と ARM のどちらにも対応し、管理者権限は要りません。コード署名はないため、初回は SmartScreen の警告が出ることがあります。
常に最新版に転送される固定リンク: https://mp3rgain.tyna.ninja/download/windows
GitHub 上の直接の URL: https://github.com/M-Igashi/mp3rgain/releases/latest/download/mp3rgui-windows-setup.exe
コマンドライン版とアプリのどちらを使うか
どちらも同じ処理コードを使っています。使い方に合わせて選んでください。
- mp3rgui（アプリ）: ドラッグ＆ドロップで操作したい、アルバムを数枚処理したい、変更前に保存済みの ReplayGain タグを確認したい場合。日本語で表示されます。
- mp3rgain（コマンドライン）: スクリプト、cron、コンテナ、CI、
-Rでのライブラリ一括処理。mp3gain の置き換えはこちらです。出力は英語です。
既定の動作に違いがあります。アプリはクリッピング防止 (-k) と更新日時の保持 (-p) がオンで、フォルダごとに 1 アルバムとして扱います。コマンドラインの -a は指定したファイル全部を 1 アルバムとして扱います。両方を入れても競合しません。
コマンドライン版: mp3rgain
| 環境 | 入手先 | インストール | アンインストール |
|---|---|---|---|
| macOS | Homebrew | brew install M-Igashi/tap/mp3rgain | brew uninstall mp3rgain |
| macOS | MacPorts | sudo port install mp3rgain | sudo port uninstall mp3rgain |
| Windows | winget | winget install M-Igashi.mp3rgain | winget uninstall M-Igashi.mp3rgain |
| Arch Linux | AUR (third-party) | yay -S mp3rgain-bin | sudo pacman -Rns mp3rgain-bin |
| Debian 12+ / Ubuntu 22.04+ (26.04 included) | apt リポジトリ | sudo apt install mp3rgain | sudo apt remove mp3rgain |
| Any (Nix) | Nix flake | nix profile install github:M-Igashi/mp3rgain | nix profile remove mp3rgain |
| macOS / Linux | pkgx | pkgx mp3rgain | rm -rf ~/.pkgx/github.com/M-Igashi/mp3rgain |
| Android (Termux) | TUR | pkg install tur-repopkg install mp3rgain | pkg uninstall mp3rgain |
| Any | Docker | docker pull ghcr.io/m-igashi/mp3rgain:latest | docker rmi ghcr.io/m-igashi/mp3rgain |
| Any (Rust 1.85+) | Cargo | cargo install mp3rgain | cargo uninstall mp3rgain |
GitHub Releases には、macOS 用ユニバーサルバイナリの .tar.gz、Linux x86_64 / arm64 の .tar.gz、Windows x86_64 / arm64 の .zip、amd64 / arm64 の .deb もあります。Linux 用のバイナリは静的リンクなので、ディストリビューションを問わず動きます。macOS のコマンドライン版バイナリには署名がありません。ブラウザーでダウンロードしたものが macOS にブロックされた場合は xattr -d com.apple.quarantine ./mp3rgain を実行してください。
デスクトップアプリ: mp3rgui
| 環境 | 入手先 | インストール | アンインストール |
|---|---|---|---|
| macOS 11+ | Homebrew Cask | brew install --cask M-Igashi/tap/mp3rgui | brew uninstall --cask mp3rgui |
| Windows | winget | winget install M-Igashi.mp3rgui | winget uninstall M-Igashi.mp3rgui |
| Arch Linux | AUR | yay -S mp3rgui | sudo pacman -Rns mp3rgui |
| Debian 13+ / Ubuntu 24.04+ (26.04 included) | apt リポジトリ | sudo apt install mp3rgui | sudo apt remove mp3rgui |
- macOS: アプリ（DMG または Homebrew cask）は Developer ID で署名され、Apple の公証を受けています。macOS 11 以降が必要です。
- Windows:
wingetはポータブル版を入れます。スタートメニューへの登録とアンインストーラーが必要なら インストーラー を使ってください。どちらもコード署名はありません。 - Linux:
.debと tarball は Ubuntu 24.04 でビルドしており、GTK 3 が必要です。Ubuntu 24.04 以降または Debian 13 以降で使えます。
Debian と Ubuntu: apt リポジトリ
各リリースは、署名付きの apt リポジトリ（amd64 と arm64）としても公開しています。一度追加すれば apt upgrade で更新されます。mp3rgain は Debian 12 / Ubuntu 22.04 以降、mp3rgui は Debian 13 / Ubuntu 24.04 以降が対象です。
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSLo /etc/apt/keyrings/mp3rgain.gpg https://github.com/M-Igashi/mp3rgain/releases/latest/download/mp3rgain-archive-keyring.gpg
echo "deb [signed-by=/etc/apt/keyrings/mp3rgain.gpg] https://github.com/M-Igashi/mp3rgain/releases/latest/download/ ./" | sudo tee /etc/apt/sources.list.d/mp3rgain.list
sudo apt update
sudo apt install mp3rgain # または mp3rgui署名鍵のフィンガープリントは 54E7 BDDA 7581 ED3A 9689 0E9D 1697 D52D 7E5A 289D です。リポジトリは最新リリースの配布ファイルの中にあるため、新しいリリースの公開直後の数分間は apt update が Release ファイルがないと報告することがあります。少し待って再実行すれば成功します。Ubuntu の PPA (ppa:m-igashi/mp3rgain、ppa:m-igashi/mp3rgui) は非推奨で、更新は 2026-12-31 までです。移行手順は 英語版 にあります。
動作確認
ライブラリ全体に使う前に、バイナリが動くことと、バージョンが期待どおりであることを確認してください。
mp3rgain -v
# mp3rgain version 3.16.2
mp3rgain song.mp3 # 読み取りのみ。情報を表示するだけで、何も変更しませんオプションなしで実行した場合、ファイルには一切書き込みません。実際の処理も、-n を付ければ書き込まずに結果だけ確認できます。
ダウンロードしたファイルの検証（SHA-256 と、GitHub のビルド来歴証明 gh attestation verify）については 英語版のインストールガイド をご覧ください。
困ったときは
Windows 版がダウンロードできない、始まらない
https://mp3rgain.tyna.ninja/download/windows は GitHub Releases 上のインストーラーに転送されます。github.com に接続できないネットワークではダウンロードできません。また、インストーラーにコード署名がないため、ブラウザーが「一般的にダウンロードされていないファイル」として保留することがあります。その場合はファイルを保持する操作を選んでください。同じファイルとチェックサムは 最新リリースのページ にあり、winget install M-Igashi.mp3rgui ならブラウザーを使わずに入れられます。
Windows Defender や SmartScreen が警告する
Defender のクラウド判定がアプリのバイナリを誤検知することがあり、SmartScreen は署名のないプログラムに警告を出します。バイナリは、タグ付けされたソースから公開の GitHub Actions 上でビルドしており、ビルドログも公開されています。検知された場合は、配布ファイルを VirusTotal で確認するか、Microsoft に誤検知として報告してください。
mp3rgui が起動しない
macOS と Linux では OpenGL 2.0 以降で描画します。Windows は Direct3D 12 または Vulkan を使い、使えない場合はソフトウェア描画に切り替わるので、仮想マシンやリモートデスクトップでもたいてい起動します。環境変数 MP3RGUI_RENDERER=glow で OpenGL に切り替えられます。どの方法でも描画できない場合は、理由を説明するダイアログが出ます。コマンドライン版はグラフィックス機能を必要としません。
日本語のファイル名が正しく表示されない
日本語、中国語、韓国語のファイル名は、システムに入っている CJK フォントで表示します。別のフォントを使いたい場合は、環境変数 MP3RGUI_FONT にフォントファイルのパスを指定してください。