yt-dlp-audio-normalize

ffmpeg-normalize を使用した音量正規化のための yt-dlp PostProcessor プラグイン

要件

• Python >= 3.10
• yt-dlp
• ffmpeg (システムにインストール済みであること)

インストール

pip install -U yt-dlp-audio-normalize

使用方法

--use-postprocessor

# デフォルト
yt-dlp --use-postprocessor AudioNormalize URL

# パラメータを指定
yt-dlp --use-postprocessor "AudioNormalize:target_level=-14.0;audio_codec=aac" URL

# 実行タイミングを指定
yt-dlp --use-postprocessor "AudioNormalize:when=pre_process" URL

when を省略した場合、自動的に after_move で実行される。これにより、ファイルが最終パスに移動された後に音量正規化が行われる。

--ppa (PostProcessor Arguments)

yt-dlp --ppa "AudioNormalize:-t -14.0 -c:a aac -b:a 128k" URL

--use-postprocessor の kwargs と --ppa の両方が指定された場合、PPA が優先される。

自動推定

ダウンロード済みファイルのメタデータから以下のパラメータが自動的に設定される:

ユーザーが明示的に指定した値は自動推定値より優先される。

Python API

import yt_dlp
from yt_dlp_plugins.postprocessor.audio_normalize import AudioNormalizePP

with yt_dlp.YoutubeDL(opts) as ydl:
    ydl.add_post_processor(AudioNormalizePP(), when="after_move")
    ydl.download([url])

サポートされるパラメータ

FFmpegNormalize.__init__() のすべてのスカラーパラメータは、ロングフラグ(例: --target-level, --audio-codec)で自動的にサポートされる

ショートフラグ

ライセンス

Unlicense