YouTubeの音量を基準値(-14 LUFS)に統一し、ISO 226:2023準拠のラウドネス補正を行います。
このスクリプトは、YouTubeの動画（通常の動画、Shorts、ライブ配信）の音量を、放送業界標準である基準値（-14 LUFS）に自動で統一（ノーマライズ）する高機能オーディオエンジンです。
v6.4では、インジケーターの表示情報が整理され、「メタデータ（元音量）」と「実測値（リアルタイム）」の区別が明確になりました。また、YouTube本来のノーマライズ挙動（音圧が高い動画の自動減衰）を正しく認識するロジックが組み込まれています。
動画ごとの音量差をなくし、適切なレベルに調整します。
人間の耳は、音量が小さいときに低音（ベース）や高音（空気感）が聞こえにくくなる特性があります。 この機能は、再生中の音量レベルに応じて4バンドのイコライザー（サブベース・低域・中低域・高域）を動的に制御し、小音量でも「迫力」や「明瞭さ」を損なわないリッチなサウンドを提供します。
基準音量キャリブレーション機能 PCのシステム音量やスピーカーの性能はユーザーごとに異なります。 「🎧 現在の音量を基準(Flat)にする」ボタンを押すことで、あなたが「普段聴く最適な音量」をスクリプトに学習させることができます。これにより、「基準より音量を絞った時だけ補正をかける」という、高級オーディオアンプと同様の自然な聴感補正を実現します。
動画データ（メタデータ）の有無に応じて、最適な処理モードと表示を自動で切り替えます。
| モード | インジケーター表示 | 動作内容 |
|---|---|---|
| Stable (Static) | 元音量 (Meta) | YouTubeの音量情報（loudnessDb）を使用し、瞬時に目標値へ合わせます。メタデータが基準値以上の場合はYouTubeの自動調整を尊重し、スクリプトは介入しません。 |
| AGC | 計測値 (Real-time) | ライブ配信やメタデータがない動画では、音声をリアルタイムで解析（BS.1770準拠）し、滑らかに音量を調整します。 |
| AGC-Hold | (Wait) | 無音区間でノイズが持ち上がるのを防ぐため、直前の音量レベルを維持（ゲート処理）します。 |
YouTube標準の「一定音量（Stable Volume）」機能は、本スクリプトの処理と競合し、音質劣化を招く場合があります。 本スクリプトは、ブラウザのストレージレベルでこの機能をフックし、強制的にOFFにする機能を搭載しています。これにより、常にスクリプト側の高精度な処理が優先されます。
Shorts動画特有の通信（/reel）やスクロール動作を最適化して監視するため、次々と動画をスワイプしても瞬時に音量が適正化されます。
インジケーターアイコンをクリックすると設定メニューが開きます。
| 設定項目 | デフォルト | 説明 |
|---|---|---|
| YouTube「一定音量」を強制OFF | ON (有効) | YouTube標準のノーマライズ機能を無効化し、本スクリプトの制御を優先します。二重補正を防ぐため、ONのまま使用することを推奨します。 |
| 等ラウドネス補正 (Dynamic EQ) | OFF (無効) | 音量を絞った際に、聴感上の低音・高音不足を補正します（ラウドネス・コンペンセーション）。 |
| └ 🎧 現在の音量を基準(Flat)にする | - | 【重要】 Dynamic EQ有効時に表示されます。普段よく聴く「少し大きめ（快適）」な音量に合わせてこのボタンを押してください。その位置を「補正なし（Flat）」の基準点として記憶します。 |
| 常にAGCモードを使用 | OFF (無効) | メタデータの有無にかかわらず、全ての動画でリアルタイム解析を行います。通常はOFF推奨です。 |
| AGC判定を安定化 (疑似Stable) | OFF (無効) | AGCモード時の音量判定時間を通常の3秒から10秒に延長します。ライブ配信などで音量が細かく変動するのを防ぎたい場合に有効です。 |
画面ヘッダー（通知アイコン付近）のボタンの色で、現在の動作ステータスがわかります。ツールチップには詳細なLUFS値が表示されます。
| 色 | ステータス | ツールチップ表示 | 意味 |
|---|---|---|---|
| ■ 緑 | Stable | 元音量 (Meta) | メタデータに基づき適用中。最も安定しています。 ※+値の場合は0dB補正として扱われます。 |
| ■ 水色 | AGC | 計測値 (Real-time) | リアルタイム解析値に基づいて補正中（ライブ配信等）。 |
| ■ 黄 | Init | - | 動画を検出中、または初期化処理中。 |
| ■ 橙 | Native | 元音量 (Meta) | スクリプトが無効化され、YouTube標準機能またはバイパス状態で動作中。 |
| ■ 紫 | Fix | - | ストリームの修復（再読み込み・シーク）を試行中。 |
| ■ 青灰 | Fail | - | 音声取得エラーにより機能停止中。 |
ツールチップ詳細:
マウスオーバーすると、現在の入力LUFS値、現在の補正ゲイン（dB）、およびDynamic EQが有効な場合はそのブースト量（例: [DynEQ: +3.0dB]）が表示されます。
loudnessDbが正の値（-14 LUFSより大きい）の場合、YouTubeプレーヤーは自動的に音量を下げて再生します。本スクリプトはこの挙動を検知し、計算上のオフセットを0dBとすることで、過剰な音量低下を防いでいます。