Ahmed Doghri Logo Image
Ahmed Doghri

codecguard

A clean candidate passes four gates. A low-pass, stereo-collapsed build is blocked on spectrum, transients, width, and SNR.

codecguard waveform compression quality gate
codecguard working browser demo

Codec Changes Need Regression Tests

A successful transcode only proves that a decoder can open the result. It says nothing about lost attacks, collapsed width, spectral smearing, or accidental silence.

codecguard synthesizes a deterministic stereo master, runs a real FFmpeg encode and decode, aligns encoder priming, and evaluates four independent dimensions.

The Demo

The release candidate reaches 33.396 dB SNR, 0.02087 spectral convergence, 0.9954 transient retention, and 0.00025 stereo-width error, passing every gate. The degraded build fails all four.

Signal metrics make CI deterministic but do not replace perceptual codecs, formal listening panels, or content-diverse mastering review.

Implementation Basis

The gate combines multi-resolution frequency evidence with time-domain transients, stereo energy, and aligned waveform error.

Read the FFmpeg codec documentation.

Tools Used

Python
NumPy
FFmpeg
Audio DSP
Codec QA
Docker
GitHub Actions CI