audio-quality-controller — Claude Code subagent: how to install
audio-quality-controller inspects audio files, trims noise, and normalizes loudness to broadcast levels via FFmpeg. Built for podcast production and clean vocal pipelines.
no license 547 installs updated 2026-10-24
npx claude-code-templates@latest --agent ffmpeg-clip-team/audio-quality-controllerWhat audio-quality-controller does
This subagent inspects recorded tracks inside Claude Code to reach broadcast-ready output. It evaluates metrics such as integrated LUFS, True Peak ceilings, loudness range (LRA), and signal-to-noise ratios. For podcast files, it aims around -16 LUFS and -1.5 dBTP.
The assistant relies on Bash, Read, and Write permissions to assemble and run ffmpeg filter chains. It applies multi-stage audio processing: high-pass filters for rumble, de-essing between 5-8 kHz, gentle compression ratios, and loudnorm passes. Following each run, it compiles a structured JSON review covering detected flaws, before-and-after readings, and a 1-to-10 improvement score.
Without ffmpeg installed in your system PATH, this agent will fail completely because every inspection and filter step runs through shell commands. Working with uncompressed audio like WAV or FLAC gives the cleanest results.
What it helps with
- normalize podcast loudness to standard target levels like -16 LUFS
- cut background hum and room resonance with high-pass filtering
- tame harsh sibilance using parametric equalization
- generate detailed JSON reports covering True Peak and dynamic range
Example prompts for the agent
- Analyze
episode1.wavand normalize the loudness to -16 LUFS. - Remove low-end rumble and excessive sibilance from
recording.wav. - Process
interview.flacthrough the complete compression chain and output a JSON quality report.
How to install audio-quality-controller
1claude-code-templates
npx claude-code-templates@latest --agent ffmpeg-clip-team/audio-quality-controller2Manually: put the files in place
.claude/agents/audio-quality-controller.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/audio-quality-controller.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/audio-quality-controller.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about audio-quality-controller
How to install audio-quality-controller in Claude Code?
In Claude Code, run npx claude-code-templates@latest --agent ffmpeg-clip-team/audio-quality-controller or place the agent prompt file into .claude/agents/audio-quality-controller.md.
What does audio-quality-controller do?
It checks audio recordings against broadcast benchmarks and runs automated ffmpeg commands to balance loudness, clear background noise, and correct frequencies.
What dependencies are required to run this subagent?
You must have ffmpeg installed and available in your environment, as the agent executes audio analysis and filter graphs directly through Bash.