https://github.com/olbrichattila/audionorm
Audio Normalization Tool for MP3 to WAV Conversion
https://github.com/olbrichattila/audionorm
audio-normalization audio-processing golang-cli normalization
Last synced: about 2 months ago
JSON representation
Audio Normalization Tool for MP3 to WAV Conversion
- Host: GitHub
- URL: https://github.com/olbrichattila/audionorm
- Owner: olbrichattila
- Created: 2024-12-02T19:10:14.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-01-07T22:16:52.000Z (5 months ago)
- Last Synced: 2025-02-08T02:44:36.496Z (4 months ago)
- Topics: audio-normalization, audio-processing, golang-cli, normalization
- Language: Go
- Homepage:
- Size: 16.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# audionorm: Audio Normalization Tool for MP3 to WAV Conversion
`audionorm` is a powerful and easy-to-use command-line tool written in Go. It allows you to normalize the volume of audio files in bulk. The tool processes **MP3 files** from a specified folder and outputs normalized **WAV files** with consistent volume levels, making it ideal for podcast editing, music libraries, and audio projects.
## Key Features
- **Batch Processing**: Normalize multiple MP3 files at once.
- **Custom Normalization Factor**: Set your desired volume level (0 to 1).
- **MP3 to WAV Conversion**: Outputs normalized files in WAV format.
- **Ease of Use**: Simple command-line interface.
## Installation
To install `audionorm`, ensure you have [Go](https://golang.org/) installed, then run:
```
go install github.com/olbrichattila/audionorm/cmd/audionorm@latest
```
## How to Use audionorm
Basic Command Syntax
```
audionorm -factor= -help
```
### Parameters
- path: (Optional) Specifies the folder containing MP3 files. Defaults to the current working directory if not provided.
- -factor: (Optional) A normalization factor between 0 and 1 (e.g., 0.8 for 80% of max volume). Defaults to 1 (no reduction in volume).
- -help: (Optional) Displays usage instructions and exits.
### Examples of Usage
1. Normalize audio in the current directory with default settings:
```
audionorm
```
2. Normalize audio in the current directory with a factor of 0.8:
```
audionorm -factor=0.8
```
3. Normalize audio in a specific folder (./myfolder) with default settings:
```
audionorm ./myfolder
```
4. Normalize audio in ./myfolder with a factor of 0.8:
```
audionorm ./myfolder -factor=0.8
```
5. Display help information and usage instructions:
```
audionorm -help
```
6. Set a low over-amplification tolerance (e.g., 2):
```
audionorm ./folder -tolerance=2
```
7. Set a hight over-amplification tolerance (e.g., 2):
```
audionorm ./folder -tolerance=20
```
8. Convert it back to MP3:
```
audionorm . -mp3
```
> Note: This feature requires ffmpeg to be installed:
Examples of installing:
### Linux (APT):
```
sudo apt update
sudo apt install ffmpeg
```
### Linux: Fedora/CentOS
```
sudo dnf install ffmpeg
```
### Linux: Arch
```
sudo pacman -S ffmpeg
```
### Compiling:
```
sudo apt-get update
sudo apt-get install -y autoconf automake build-essential libtool pkg-config
sudo apt-get install -y libx264-dev libx265-dev libvpx-dev
```
```
git clone https://git.ffmpeg.org/ffmpeg.git ffmpeg
cd ffmpeg
./configure
make
sudo make install
```
### macOS: Using Homebrew (Recommended)
```
Install homebrew if not yet installed:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
```
brew install ffmpeg
```
### Using MacPorts:
```
sudo port install ffmpeg
```
### Windows: Using Chocolatey (Recommended)
```
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
choco install ffmpeg
```
### Or download and manually install:
https://ffmpeg.org/download.html#build-windows
## Tolerance Feature
The tolerance feature allows the program to handle naturally occurring high volumes without clipping or distortion. By setting a tolerance level, the program will permit a certain amount of over-amplification, enabling loud segments to remain audible and impactful.
- Key Parameter: -tolerance=
- Range: 0 to 20
- 0 (default): Disables over-amplification.
- 1-20: Gradually increases the permissible over-amplification level, where higher values allow greater tolerance.
### How It Works
When -tolerance is set, the utility adjusts its normalization process to allow some high-volume segments to exceed the standard threshold. This is particularly useful for dynamic audio content, such as music or dialogue, where peaks contribute to the overall experience.
For instance, a tolerance value of 2 permits minor over-amplification, while a value of 20 allows significant amplification for dramatic peaks.
## What Does the Normalization Factor Do?
The normalization factor adjusts the output volume:
- 1: Retains the original volume.
- 0.8: Reduces the volume to 80%.
- Values closer to 0: Significantly lower the volume.
This flexibility ensures that your audio output meets your specific needs, whether you are fine-tuning a podcast or preparing a uniform music library.
Benefits of Using audionorm
- Save time by batch processing audio files.
- Ensure consistent audio quality across all files.
- Easy integration into automated workflows and scripts.
### License
This project is licensed under the MIT License. Feel free to use, modify, and distribute this tool.
Coming soon.
- Bitrate setup,
- wav as input file
## About me:
- Learn more about me on my personal website. https://attilaolbrich.co.uk/menu/my-story
- Check out my latest blog blog at my personal page. https://attilaolbrich.co.uk/blog/1/single