enhance-audio

CLI tool that denoises audio with DeepFilterNet and normalizes loudness to -16 LUFS using ffmpeg.

Requirements

• Python ≥ 3.10
• ffmpeg available in $PATH
• uv

# Install required tools (macOS)
brew install python@3.14 uv ffmpeg

Install as a global tool

# Clone this repo
git clone https://github.com/yyongpil/enhance-audio.git

# Install from local source
uv tool install ./enhance-audio

Usage

enhance-audio path/to/recording.wav
enhance-audio path/to/recording.m4a   # m4a is auto-converted to wav first

Output is saved as {original_name}_enhanced.wav in the same directory as the input file.

What it does

1. (m4a only) Converts the input to WAV via ffmpeg
2. Noise reduction — DeepFilterNet (48 kHz, full-band model)
3. Loudness normalization — loudnorm=I=-16:TP=-1.5:LRA=11 and encode to AAC 192kbps via ffmpeg

Tested and works on

1. macOS 26.4 (M1 Pro)

enhance-audio

DeepFilterNet으로 오디오 노이즈를 제거하고 -16 LUFS로 음량을 정규화하는 CLI 도구입니다.

요구 사항

• Python ≥ 3.10
• ffmpeg — $PATH에 등록되어 있어야 합니다
• uv

# 필요한 툴 설치 (macOS)
brew install python@3.14 uv ffmpeg

글로벌 CLI 도구로 설치

# 다운로드
git clone https://github.com/yyongpil/enhance-audio.git

# 로컬 소스에서 설치
uv tool install ./enhance-audio

사용법

enhance-audio path/to/recording.wav
enhance-audio path/to/recording.m4a   # m4a는 자동으로 wav로 변환 후 처리

출력 파일은 입력 파일과 같은 디렉토리에 {원본파일명}_enhanced.m4a로 저장됩니다.

처리 순서

1. (m4a 파일인 경우) ffmpeg로 WAV 변환
2. 노이즈 제거 — DeepFilterNet3 (48kHz, 풀밴드 모델)
3. 음량 정규화 — ffmpeg loudnorm=I=-16:TP=-1.5:LRA=11로 -16 LUFS 정규화 후 AAC 192kbps M4A로 인코딩

아래 환경에서 작동되는 것 확인됨

1. macOS 26.4 (M1 Pro)