~/content/06-troubleshooting.mdβΌ
No pages yet. In Files, use "Set as Page" on a markdown or HTML file.
Frontmatter
{
"title": "Troubleshooting Guide",
"created": "2026-11-05T23:00:00Z",
"updated": "2026-11-05T23:00:00Z",
"slug": "troubleshooting"
}Troubleshooting Guide
1. Audio is Locked / No Sound
Modern browsers prevent Web Audio contexts from producing sound without a user interaction.
- Solution: Open the workbench page at
/main/and click the "π Start Audio" button in the transport bar. - Note: Background tools (
scdaw_set_track,scdaw_write_notes,scdaw_bounce) continue to function even while real-time audio playback is locked.
2. Tool Timed Out Awaiting DAW Response
Worker tools dispatch commands via BroadcastChannel("scdaw-commands"). If no browser tab has the workbench open, commands will time out after 5 seconds (or 30 seconds for scdaw_bounce).
- Solution: Navigate to
/main/in an active browser tab.
3. Multiple Tabs & Leader Election
Only one tab acts as the primary audio leader to avoid audio stutter and duplicate tool executions.
- Web Locks elect the first tab as the leader. Closing the leader tab automatically passes control to the next open workbench tab.
4. Metronome Click Sound
- How it Works: Clicking "π Metro" (
#metro-btn) enables the metronome click track. When toggled on while stopped, the DAW unlocks audio (if needed) and plays an instant audition click. During playback or recording, the metronome synthesizes woodblock-style click pulses on every quarter-note beat with an accented pitch on beat 1 (downbeat) following the project tempo and time signature.