@audio/dynamics-leveler

Gain-riding dialogue leveler — framewise loudness normalization (FFmpeg dynaudnorm / Waves Vocal Rider class)

npm install @audio/dynamics-leveler

import leveler from '@audio/dynamics-leveler'

Framewise RMS is measured, converted to a gain toward target, gaussian-smoothed across frame neighbors, then peak-guarded so no frame is pushed past −0.5 dBFS. Gain is linearly interpolated between frame centers and applied in place. Batch only, non-causal by design — the smoothing looks at frames on both sides of each point, so there is no streaming form.

leveler(data)                                    // target -20 dB, mutates and returns data
leveler(data, { target: -18, frame: 0.3, maxGain: 9, smooth: 3 })

| Param | Default | | |---|---|---| | fs | 44100 | Hz | | target | -20 | dB, RMS loudness target | | frame | 0.5 | s, analysis window | | maxGain | 12 | dB, symmetric gain clamp per frame | | smooth | 5 | frames, gaussian smoothing radius |

Use when: dialogue/podcast loudness riding, evening out a take without pumping. Not for: real-time/streaming use (no streaming form) — use compressor or compand for causal leveling.

Part of @audio/dynamics — the dynamics family umbrella.

MIT © audiojs