slhck/ffmpeg-normalize
Ffmpeg Normalize
This utility is a command-line tool designed to automate volume leveling across audio and video collections. By leveraging external media processing libraries, it adjusts files to a consistent target loudness level, ensuring uniform playback without the need for manual volume adjustments.
The tool distinguishes itself through a two-pass analysis workflow that measures loudness statistics before applying precise gain adjustments. It maintains the relative loudness relationships between tracks when processing collections, ensuring that the dynamic balance of a group of files remains intact. Users can define and save custom configuration presets to standardize these normalization parameters across different media types and environments.
The software supports comprehensive batch processing, allowing for the automated normalization of entire directories while preserving original metadata and file integrity. It includes logic to evaluate files against target thresholds, skipping redundant re-encoding to optimize computational resources. Additionally, the tool provides dynamic stream mapping to isolate specific audio tracks within video containers, enabling normalization without altering the original video content.
The utility is distributed as a command-line interface and includes shell autocompletion support for terminal-based operations. It also offers a programmatic interface for integration into custom applications and automated media processing pipelines.
Features
- Cross-Track Loudness Leveling - Automates volume leveling across media collections to ensure uniform playback without manual adjustments.
- Loudness Normalization Standards - Adjusts audio files to a consistent target loudness level using automated analysis to ensure uniform volume across multiple media files.
- Batch Media Processors - Provides a terminal-based workflow for normalizing entire directories of audio and video files while preserving metadata and relative loudness.
- Media Processing Orchestrators - Executes command-line media tools as child processes to leverage high-performance native libraries for complex audio signal analysis and transcoding.
- Normalization Tools - Adjusts audio and video files to a consistent target loudness level using FFmpeg as the underlying processing engine.
- Conditional Execution Gates - Evaluates file metadata and loudness metrics against target thresholds to skip redundant re-encoding and optimize computational resources.
- Media Encoding Pipelines - Integrates audio processing into custom scripts or containerized pipelines to handle media normalization without manual intervention.
- Batch Processing - Supports batch processing of entire directories or collections of audio and video files to ensure uniform loudness levels across large media libraries.
- Audio Stream DSP - Targets specific audio streams within a media file for normalization while leaving other tracks untouched to maintain file structure.
- Media Processing Presets - Serializes user-defined normalization parameters into persistent files to standardize processing workflows across different media types.
- Simultaneous Audio and Video Extractors - Extracts and normalizes audio streams within video files while preserving the original video content and quality.
- Video Post-Processing - Normalizes audio tracks within video files while preserving original video quality and stream structure for final distribution.
- Video Stream Metadata Parsing - Parses media container structures to isolate specific audio tracks for processing while preserving video streams and metadata intact.
- Multi-Pass Analysis - Performs an initial scan to measure loudness statistics before executing a second pass to apply precise gain adjustments.
- Queue Management - Orchestrates the processing of file collections to maintain relative loudness relationships across multiple tracks.
