Loudness Balance Monitor

Loudness Balance Monitor 0.1.3

Go to download
Overview Updates (2) History Discussion
Supported Bit Versions
  1. 64-bit
Source Code URL
https://github.com/AllegroMoltoV/obs-loudness-balance-monitor
Minimum OBS Studio Version
31.0.0
Supported Platforms
  1. Windows

概要​


音量バランスモニター（Loudness Balance Monitor）は、OBS Studio 向けのリアルタイム音量バランス監視プラグインです。配信中に「声が BGM に埋もれている」「全体の音量が小さい」といった問題を視覚的にフィードバックし、適切な音量バランスを維持するのを支援します。

obs-loudness-balance-monitor-lite.gif


機能​


リアルタイム音声解析​

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

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

インジケーター説明
バランス声と BGM のバランス（緑: +6 LU 以上、黄: +3〜+6 LU、赤: +3 LU 未満）
ミックス全体の音量レベル（緑: -18 LUFS 以上、黄: -22〜-18 LUFS、赤: -22 LUFS 未満）
クリップピークレベル（緑: -1 dBFS 未満、黄: -1〜0 dBFS、赤: 0 dBFS 以上）

ドック UI​

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

設定項目​

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

対応言語​

  • 日本語
  • 英語

動作環境​

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

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

インストール方法​


Windows​

  1. Releases から
    Code: 
    loudness-balance-monitor-0.1.3-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. 初回はメニュー「ドック」→「音量バランスモニター」から表示。次回以降は終了時の表示状態を復元

ポータブル版 OBS 32.1.2 では、DLL を
Code: 
obs-plugins/64bit
、言語ファイルを
Code: 
data/obs-plugins/loudness-balance-monitor/locale
に配置して動作を確認しました。この配置は OBS の公式ガイドで旧方式とされています。詳細は README.md をご覧ください。

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

現在、macOS / Linux 向けのビルド済みバイナリは配布していません。以下の手順でソースからビルドしてください。

Bash: 
# 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

詳細は README.md を参照してください。

使い方​

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

既知の制限事項​

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

技術詳細​

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

ライセンス​

GPL-2.0（OBS Studio と同一ライセンス）

クレジット​

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


全変更履歴: https://github.com/AllegroMoltoV/obs-loudness-balance-monitor/commits/v0.1.3


Overview​


Loudness Balance Monitor is a real-time loudness/balance monitoring plugin for OBS Studio. During a livestream, it provides visual feedback for common problems such as “my voice is buried under the BGM” or “the overall volume is too quiet,” helping you maintain a healthy loudness balance.

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​

IndicatorDescription
BalanceVoice vs. BGM balance (Green: +6 LU or higher, Yellow: +3 to +6 LU, Red: below +3 LU)
MixOverall loudness level (Green: -18 LUFS or higher, Yellow: -22 to -18 LUFS, Red: below -22 LUFS)
ClipPeak level (Green: below -1 dBFS, Yellow: -1 to 0 dBFS, Red: 0 dBFS or higher)

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.3 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.3-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. On first use, show the dock via Docks → Loudness Balance Monitor. On later launches, its visibility is restored from the last normal exit

On portable OBS Studio 32.1.2 for Windows, the plugin loaded with the DLL in
Code: 
obs-plugins/64bit
and the locale files in
Code: 
data/obs-plugins/loudness-balance-monitor/locale
. The OBS plugin guide describes this layout as legacy. See README.md for details.

macOS / Linux (Build from source)​

Currently, no prebuilt binaries are provided for macOS / Linux. Please build from source using the steps below.

Bash: 
# 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

For more details, see README.md.

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​

GPL-2.0 (same license as OBS Studio)

Credits​



Full changelog: https://github.com/AllegroMoltoV/obs-loudness-balance-monitor/commits/v0.1.3




AI利用開示​

v0.1.0までの制作では、Anthropic Claude Codeをソースコード、ビルド設定、テスト、文書を含むほぼすべての工程で使用しました。その後の修正では、OpenAI Codexを同様にほぼすべての工程で使用しました。プロジェクトREADMEとOBS Forum掲載文の作成・改稿にもCodexを使用しています。

作者本人はWindows上のOBS Studioでユーザーテストを実施しました。コード読解による厳密な人間レビューは実施していません。リソースアイコンはClaude Codeが出力したSVGから作成しました。概要説明欄のアニメーションGIFは、作者本人がScreenToGifで画面収録したもので、生成AIを使用していません。

AI Disclosure​

Anthropic Claude Code was used for almost the entire development process through v0.1.0, including source code, build configuration, tests, and documentation. OpenAI Codex was used in a similar capacity for almost all subsequent revisions. Codex was also used to draft and revise the project README and OBS Forum resource description.

The author performed user testing in OBS Studio on Windows but did not perform a rigorous human review of the source code. The resource icon was created from an SVG generated by Claude Code. The animated GIF in the resource description was screen-recorded by the author using ScreenToGif, without generative AI.
  • Like
Reactions: Mishasama
Author
AllegroMoltoV
Downloads
2,784
Views
7,431
First release
Last update

Ratings

0.00 star(s) 0 ratings
Join the discussion

More resources from AllegroMoltoV

  • Simple Drop Shadow
    Simple Drop Shadow
    シンプルな「ドロップシャドウ」プラグイン
  • Simple Pitch Shift
    Simple Pitch Shift
    「半音」スライダー (-12..+12) を操作し、音声のピッチを変更。低遅延を優先したため音質はそこそこ。

Share this resource

Latest updates

  1. v0.1.3: OBS再起動後のドック表示状態を復元

    v0.1.3では、OBSを終了したときの音量バランスモニタードックの表示状態を次回起動時に復元するよう修正しました。前回表示していた場合は表示し、非表示だった場合は非表示のまま起動します。...

  2. v0.1.2: macOS ビルド修正と OBS 32.1.2 での動作確認

    v0.1.2 では、macOS 26 の CI で発生していた -framework AGL のリンクエラーを、Qt...
Read more…
Back
Top