Loudness Balance Monitor 0.1.1

概要​

機能​

リアルタイム音声解析​

• 音声検出（VAD）: 声の有無を自動検出（しきい値調整可能）
• ラウドネス計測: libebur128 を使用した業界標準の Short-term LUFS 計測
• ピーク検出: クリッピング（音割れ）をリアルタイムで検出

3つのステータスインジケーター​

ドック UI​

• 声ソース（マイク）の選択
• 複数 BGM ソースの選択（チェックボックス式）
• LUFS メーター（数値表示付き）
• 設定の永続化
• 縦スクロール対応
• ヘルプ / 使い方の表示

設定項目​

• 検出しきい値: 音声検出のしきい値（-60〜-20 dB）
• 目標バランス: 目標バランス値（0〜20 LU）
• ミックス基準: プリセット選択（YouTube 標準 / 小さめ安全 / 大きめ攻め）

対応言語​

• 日本語
• 英語

動作環境​

• OBS Studio 31.0.0 以上
• Windows 10/11 (x64)

注意: v0.1.0 では Windows 向けバイナリのみ配布しています。macOS / Linux をご利用の方はソースからビルドしてください。

Click to expand...

インストール方法​

Windows​

1. Releases から
   Code:

   loudness-balance-monitor-0.1.0-windows-x64.zip

   をダウンロード
2. OBS Studio を終了
3. ZIP を展開し、
   Code:

   loudness-balance-monitor

   フォルダを
   Code:

   %PROGRAMDATA%

   フォルダ内の
   Code:

   obs-studio\plugins

   にコピー
   • 通常:
     Code:

     C:\ProgramData\obs-studio\plugins\

4. OBS Studio を起動
5. メニュー「ドック」→「音量バランスモニター」を有効化

macOS / Linux（ソースからビルド）​

# macOS
cmake --preset macos
cmake --build --preset macos --config RelWithDebInfo
cmake --install build_macos --prefix /path/to/obs-studio/plugins

# Ubuntu
cmake --preset ubuntu-x86_64
cmake --build --preset ubuntu-x86_64 --config RelWithDebInfo
sudo cmake --install build_x86_64

使い方​

1. ドックで「声」ソース（マイク入力）を選択
2. モニターしたい BGM ソースにチェック
3. 配信中はステータスインジケーターを確認:
   • 緑 = 良好
   • 黄 = 注意
   • 赤 = 問題あり

既知の制限事項​

• ミックス計算: 声 + 選択した BGM ソースの合算推定値です。OBS のマスター出力とは異なる場合があります
• True Peak: 未実装（Sample Peak のみ）
• 自動調整: 音量の自動調整機能はありません（監視のみ）

技術詳細​

• スレッドモデル: 音声コールバック → ロックフリーキュー → ワーカースレッド → アトミック結果 → UI (10Hz)
• LUFS 計測: libebur128 v1.2.6（静的リンク）
• 音声検出: Attack 150ms / Release 600ms のステートマシン
• ヒステリシス: ±0.5 dB でステータスの点滅を抑制

ライセンス​

クレジット​

• libebur128 - LUFS 計測ライブラリ (MIT License)
• OBS Studio - プラグインテンプレートおよび API

Overview​

Features​

Real-time audio analysis​

• Voice Activity Detection (VAD): Automatically detects whether voice is present (threshold adjustable)
• Loudness measurement: Industry-standard Short-term LUFS measurement using libebur128
• Peak detection: Detects clipping (distortion) in real time

Three status indicators​

Dock UI​

• Select a voice source (microphone)
• Select multiple BGM sources (checkbox list)
• LUFS meters (with numeric readouts)
• Persistent settings
• Vertical scrolling support
• Built-in help / usage guide

Settings​

• Detection Threshold: VAD threshold (-60 to -20 dB)
• Target Balance: Target balance value (0 to 20 LU)
• Mix Preset: Preset selection (YouTube Standard / Safer (Quieter) / Aggressive (Louder))

Languages​

• Japanese
• English

System Requirements​

• OBS Studio 31.0.0 or later
• Windows 10/11 (x64)

Note: v0.1.0 provides prebuilt binaries for Windows only. For macOS / Linux, please build from source.

Click to expand...

Installation​

Windows​

1. Download
   Code:

   loudness-balance-monitor-0.1.0-windows-x64.zip

   from Releases
2. Quit OBS Studio
3. Extract the ZIP and copy the
   Code:

   loudness-balance-monitor

   folder into
   Code:

   %PROGRAMDATA%\obs-studio\plugins\

   • Typical path:
     Code:

     C:\ProgramData\obs-studio\plugins\

4. Launch OBS Studio
5. Enable the dock via Docks → Loudness Balance Monitor

macOS / Linux (Build from source)​

# macOS
cmake --preset macos
cmake --build --preset macos --config RelWithDebInfo
cmake --install build_macos --prefix /path/to/obs-studio/plugins

# Ubuntu
cmake --preset ubuntu-x86_64
cmake --build --preset ubuntu-x86_64 --config RelWithDebInfo
sudo cmake --install build_x86_64

Usage​

1. In the dock, select the Voice source (microphone input)
2. Check the BGM sources you want to monitor
3. During streaming, watch the status indicators:
   • Green = OK
   • Yellow = Warning
   • Red = Problem

Known Limitations​

• Mix calculation: This is an estimated sum of Voice + selected BGM sources. It may differ from OBS’s master output.
• True Peak: Not implemented (sample peak only).
• Auto adjustment: No automatic volume adjustment is provided (monitoring only).

Technical Details​

• Thread model: Audio callback → lock-free queue → worker thread → atomic results → UI (10 Hz)
• LUFS measurement: libebur128 v1.2.6 (statically linked)
• Voice detection: State machine with Attack 150 ms / Release 600 ms
• Hysteresis: ±0.5 dB to reduce indicator flicker

License​

Credits​

• libebur128 - LUFS measurement library (MIT License)
• OBS Studio - Plugin template and API