slhck/ffmpeg-normalize

Health v2 · maintenance only

Flags: no_license

Adoption not part of the score

1529 stars · 129 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A Python-based CLI tool and library that batch-normalizes audio in media files using ffmpeg, supporting EBU R128 loudness, RMS, and peak normalization. It can process video files while preserving video streams and is also usable programmatically via a Python API.

Use cases

• normalize audio loudness of video files to EBU R128
• batch normalize a folder of audio files
• peak-normalize wav files to a target level
• normalize audio without re-encoding the video stream
• write ReplayGain tags to a music collection
• normalize album tracks jointly preserving relative loudness
• skip files already at target loudness in a batch job
• use loudness normalization from a Python script

When to choose

• you need standards-based EBU R128 loudness normalization with ffmpeg
• you want batch processing of mixed audio/video files
• you need a Python API or Docker image for normalization pipelines
• you want to skip re-encoding files already at target level

When to avoid

• you need real-time or streaming audio normalization
• you want lossless normalization of a music collection without re-encoding (use --replaygain or a dedicated tagger)
• you cannot install a recent ffmpeg with the loudnorm filter
• you need graphical batch audio editing

Facets

cli-tool · maturity active

audio-processing cli video-processing media developer-tools windows python cli cross-platform ffmpeg loudness-normalization ebu-r128 loudnorm peak-normalization rms-normalization replaygain batch-processing audio command-line linux macos docker

Member repositories

For agents

markdown · JSON · MCP: product_card(name="slhck/ffmpeg-normalize")