audio-headless-debug

Reproduce and debug audio plugin bugs in headless environments without a DAW.

1|Updated Jul 11, 2026
One-click install
npx skills add https://github.com/danielraffel/burl --skill audio-headless-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: audio-headless-debug
Source: https://github.com/danielraffel/burl/tree/main/.agents/skills/audio-headless-debug
Command: npx skills add https://github.com/danielraffel/burl --skill audio-headless-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires audio_metrics.hpp, audio_assertions.hpp, headless.hpp, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides headless environments for reproducing and debugging audio plugin bugs offline, enabling developers to isolate and fix issues without the need for a Digital Audio Workstation (DAW).

Core Features & Use Cases

  • Headless Processor Scene: Execute DSP bugs deterministically without DAW dependencies.
  • Standalone AU Host Probe: Simulate real adapter and render paths for host-interaction bugs.
  • Use Case: When a plugin misbehaves in a DAW, this Skill can help identify and fix the issue by running tests in a headless environment.

Quick Start

Use the audio-headless-debug skill to reproduce an audio plugin bug in a headless environment by running the following command: audio-headless-debug --reproduce --input <path_to_input>

Frequently Asked Questions about audio-headless-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I reproduce an audio plugin bug that only happens in a DAW?

You can reproduce audio plugin bugs offline using a headless environment with standalone AU host probes. This isolates DAW-specific DSP issues deterministically without launching a full digital audio workstation.

What is headless DSP testing for audio plugins?

Headless DSP testing executes audio plugin processing logic offline without DAW dependencies, using standalone host probes to simulate real adapter and render paths for deterministic bug reproduction.

How do I test an Audio Unit plugin offline without a host application?

You can test Audio Unit plugins offline using standalone AU host probes within a headless environment, simulating real adapter and render paths to identify host-interaction bugs without a DAW.

Do I need specific headers to run headless audio debugging environments?

Yes, headless audio debugging requires specific audio analysis headers and framework components, including audio_metrics.hpp, audio_assertions.hpp, and headless.hpp to execute deterministic offline plugin tests.

What's the best way to debug audio unit host-interaction bugs deterministically?

The best way to debug audio unit host-interaction bugs deterministically is using a headless environment with standalone AU host probes, simulating real adapter and render paths offline to isolate exact plugin failure conditions.

Why does my audio plugin work in standalone tests but fail in a DAW?

Audio plugins often fail in DAWs due to host-interaction bugs that standalone tests miss. Headless debugging with standalone AU host probes simulates real adapter and render paths to reproduce these DAW-specific issues offline.