https://github.com/slhck/ffmpeg-normalize

Audio Normalization for Python/ffmpeg
https://github.com/slhck/ffmpeg-normalize

audio ffmpeg python

Last synced: 6 months ago
JSON representation

Audio Normalization for Python/ffmpeg

• Host: GitHub
• URL: https://github.com/slhck/ffmpeg-normalize
• Owner: slhck
• License: mit
• Created: 2014-07-31T08:55:49.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2025-04-15T18:53:01.000Z (7 months ago)
• Last Synced: 2025-04-29T17:47:19.309Z (7 months ago)
• Topics: audio, ffmpeg, python
• Language: HTML
• Homepage:
• Size: 3.41 MB
• Stars: 1,351
• Watchers: 29
• Forks: 122
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: .github/CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-video - slhck/ffmpeg-normalize - Audio Normalization for Python/ffmpeg. (Media Analysis, Quality Metrics & AI Tools / Audio Analysis & Processing)

README

          
# ffmpeg-normalize

[![PyPI version](https://img.shields.io/pypi/v/ffmpeg-normalize.svg)](https://pypi.org/project/ffmpeg-normalize)

![Docker Image Version](https://img.shields.io/docker/v/slhck/ffmpeg-normalize?sort=semver&label=Docker%20image)

![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/slhck/ffmpeg-normalize/python-package.yml)

[![All Contributors](https://img.shields.io/badge/all_contributors-20-orange.svg?style=flat-square)](#contributors-)

A utility for batch-normalizing audio using ffmpeg.

This program normalizes media files to a certain loudness level using the EBU R128 loudness normalization procedure. It can also perform RMS-based normalization (where the mean is lifted or attenuated), or peak normalization to a certain target level.

## ✨ Features

- EBU R128 loudness normalization

- RMS-based normalization

- Peak normalization

- Video file support

- Docker support

- Python API

## 🚀 Quick Start

1. Install a recent version of [ffmpeg](https://ffmpeg.org/download.html)

2. Run `pip3 install ffmpeg-normalize`

3. Run `ffmpeg-normalize /path/to/your/file.mp4`

4. Done! 🎧 (the normalized file will be called `normalized/file.mkv`)

## 📓 Documentation

Check out our [documentation](https://slhck.info/ffmpeg-normalize/) for more info!

## 🤝 Contributors

The only reason this project exists in its current form is because [@benjaoming](https://github.com/slhck/ffmpeg-normalize/issues?q=is%3Apr+author%3Abenjaoming)'s initial PRs. Thanks for everyone's support!

  

    

      
Benjamin Balder Bach
💻

      
Eleni Lixourioti
💻

      
thenewguy
💻

      
Anthony Violo
💻

      
Eric Jacobs
💻

      
kostalski
💻

      
Justin Pearson
💻

    

    

      
ad90xa0-aa
💻

      
Mathijs
💻

      
Marc Püls
💻

      
Michael V. Battista
💻

      
WyattBlue
💻

      
Jan-Frederik Schmidt
💻

      
mjhalwa
💻

    

    

      
07416
📖

      
sian1468
⚠️

      
Panayiotis Savva
💻

      
HighMans
💻

      
kanjieater
🤔

      
Ahmet Sait
💻

    

  

  

    

      

        

          Add your contributions