Macでアプリごとに音量を変えられる定番ユーティリティ Background Music の Fork 版。
Spotify を流しながら通知音だけ小さく、Finder のプレビュー音量だけ下げる
など、アプリ別音量を、再起動後も保持する機能を拡張しています。
アプリ概要 / Overview
Background Music とは
| 項目 | 内容 |
|---|---|
| 種別 | macOS 用オーディオユーティリティ |
| 主な用途 | アプリごとの音量調整、音楽の自動一時停止、システム音声の録音 |
| 動作原理 | 仮想オーディオデバイス「Background Music」経由でシステム音声を処理 |
| UI | メニューバーアイコンから各アプリのスライダーを操作 |
| インストール | .pkg インストーラ（BGMApp + オーディオドライバ + ヘルパー） |
DPA Fork とは
kyleneideck/BackgroundMusic をベースに、わたしたちがメンテナンスする Fork です。
DPA 版で追加・強化した点
| 機能 | 説明 |
|---|---|
| 音量・パンの永続化 | bundle ID ごとに保存。BGMApp 終了・Mac 再起動後も UI に復元 |
| 再生開始時の音量復元 | 他アプリが音声 IO を開始したタイミングで、保存音量をドライバへ再適用（Finder MP3 プレビュー等） |
| past client map（ドライバ） | HAL クライアント登録前に送った音量も、再生開始時に反映 |
| ブラウザヘルパー対応 | Safari / Chrome 等のメディアヘルパープロセスへ音量操作が届きやすい（recent macOS 向け既存 Fork 機能） |
主な機能 / Features
共通機能（Background Music 本体）
- アプリ別音量 — 実行中アプリごとにスライダーで相対音量を変更（100% 超のブーストも可能）
- 自動一時停止 — 他アプリの音声再生中、音楽プレイヤーを自動 pause / 終了後に resume
対応例: Spotify, VLC, VOX, Decibel, Swinsian 等 - システム音声の録音 — QuickTime 等で入力デバイス「Background Music」を選択
- 再起動不要インストール —
.pkgから導入（インストール中に coreaudiod 再起動あり）
DPA Fork 版での拡張機能
- 再起動後も音量設定を維持
- 初回再生時の音量フラッシュ低減（IO 開始を検知して即時復元）
- 公式 0.4.3 比: スライダー表示だけでなく 実際の出力音量 も再起動後に追随
仕様 / Specifications
| 項目 | 仕様 |
|---|---|
| 対応 OS | macOS 10.13（High Sierra）以降 |
| アーキテクチャ | Apple Silicon / Intel（ユニバーサルビルド） |
| 配布形式 | .pkg インストーラ |
| 署名 | Developer ID Application / Installer |
| 公証 | Apple Notarization 済み |
| ライセンス | GPLv2 以降 |
| Bundle ID（アプリ） | com.bearisdriving.BGM.App |
| 現在のバージョン | 0.4.4-dp.1 |
| インストール先（アプリ） | /Applications/Background Music.app |
| インストール先（ドライバ） | /Library/Audio/Plug-Ins/HAL/ |
| 出力チャンネル | ステレオ（2ch）のみ |
| App Store | 非配信 |
チェックサム（v0.4.4-dp.1）
SHA256: a1035e06cde801ba153d79216c579b60510517abc2c4cd7e1e3267bb98bef8d4
ダウンロード / Download
一般ユーザー（推奨）
公式版（上流）との関係
| 配布元 | バージョン | 備考 |
|---|---|---|
| DPA Fork（本ページ） | 0.4.4-dp.1 | 音量永続化・署名 pkg |
| kyleneideck 公式 | 0.4.3 | https://github.com/kyleneideck/BackgroundMusic/releases |
| Homebrew | 上流 cask | brew install --cask background-music（DPA 版ではない） |
インストール / Installation
手順（3ステップ）
- 上記リンクから BackgroundMusic-*.pkg をダウンロード
.pkgを ダブルクリックし、画面の指示に従う（管理者パスワードが必要な場合あり）- アプリケーション → Background Music を起動
完了すると、メニューバーに Background Music のアイコンが表示されます。
インストール後の設定（任意）
- システム設定 → 一般 → ログイン項目 に追加（起動時自動実行）
- 初回起動時、マイクへのアクセスを許可（下記「注意事項」参照）
基本的な使い方 / Basic Use
- メニューバーアイコンをクリック
- リストからアプリを選び、音量スライダーを調整
- パン（左右バランス）が必要な場合は 詳細コントロール を表示
- 音量が効かないアプリは More Apps 内の
(Helper)項目を確認（Chrome / 会議アプリ等）
この Fork 版では設定した音量は Mac 再起動後も保持され、各アプリが再度音声を出し始めたときに自動で復元されます。
注意事項 / Important Notes
- 現時点では alpha 版です。本番環境での利用は自己責任でお願いします。
- Mac App Store 版ではありません。 DPA Fork 専用の
.pkgです。 - 公式 0.4.3 からの切り替え時は、先に アンインストール してから DPA 版を入れ直すことを推奨します。
- インストール時、システム音声プロセス（coreaudiod）が再起動することがあります。再生中の音声は一時停止してください。
- 初回起動時の 「マイク」許可は macOS の仕様です。Background Music はマイクで録音するのではなく、仮想入力デバイスとして音声を取得するために必要です。
- アプリ音量を 50% 超にブーストすると クリッピング（音割れ） することがあります。
- 本 Fork は kyleneideck/BackgroundMusic を改変した GPL ソフトウェアです。ソースコードは GitHub で公開されています。
アンインストール / Uninstall
- ステップ1
-
Background Music を終了（メニューバー → Quit）
- ステップ2
-
ターミナルで以下を実行
cd "/Applications/Background Music.app/Contents/Resources/"
bash uninstall.sh
手動手順: 上流 MANUAL_UNINSTALL.md
10. トラブルシューティング / Troubleshooting
| 症状 | 対処 |
|---|---|
| 音が出ない | システム設定 → サウンド で出力デバイスを変更。Background Music デバイス以外に切り替えてから戻す。 |
| クラッシュ後に無音 | 同上。出力デバイスを一度別デバイスに変更。 |
| スライダーが効かない | More Apps の (Helper) 項目を試す。 |
| マイク許可を拒否した | システム設定 → プライバシーとセキュリティ → マイク で Background Music をオン。 |
| ヘッドフォン抜き差し後に無音 | システム設定 → サウンド で出力デバイスを再選択。 |
| Chrome が認識されない | Chromium 既知バグ。音声は鳴るがメニューに表示されない場合あり。 |
不具合報告・要望
以下よりご報告ください。
https://github.com/DigiPressApps/BackgroundMusic/issues
開発者向け / For Developers
リポジトリ
ビルド要件
- Xcode 10 以上（最新 Xcode 推奨）
- Command Line Tools
- 署名・公証付き
.pkg配布: Apple Developer Program（Developer ID 証明書）
ソースからビルド・インストール
git clone https://github.com/DigiPressApps/BackgroundMusic.git
cd BackgroundMusic
/bin/bash build_and_install.sh
ワンライナー（README 準拠）
(set -eo pipefail; URL='https://github.com/DigiPressApps/BackgroundMusic/archive/master.tar.gz'; \
cd $(mktemp -d); curl -qfL# "$URL" | gzcat - | tar x && \
/bin/bash BackgroundMusic-master/build_and_install.sh -w && rm -rf BackgroundMusic-master)
.pkg の作成
cd BackgroundMusic
./package.sh
出力例
Background-Music-0.4.4-dp.1/BackgroundMusic-0.4.4-dp.1.unsigned.pkg
署名・公証後に配布用 pkg を Release に添付
（詳細は docs/RELEASE-v0.4.4-dp.1.md）。
アーキテクチャ（概要）
| コンポーネント | 役割 |
|---|---|
| BGMApp | メニューバー UI、PlayThrough、音量制御 |
| BGMDriver | 仮想 HAL デバイス、アプリ別音量処理 |
| BGMXPCHelper | ドライバとアプリの連携 |
上流への貢献
永続化機能のみを上流に提案する場合は、Fork 独自コミット（Safari/Chrome ルーティング等）との差分整理が必要です。
上流
https://github.com/kyleneideck/BackgroundMusic
ライセンス / License
- Background Music — Copyright © 2016–2024 Background Music contributors
- DPA Fork の追加変更 — © DigiPressApps
- ライセンス: GNU General Public License v2.0 以降
Apple サンプルコード部分のライセンスはリポジトリ内 LICENSE-Apple-Sample-Code を参照。