docs(asr): add dead-input troubleshooting to the asr-servers runbook #209

Merged

kblack0610 merged 1 commit from land/asr-dead-input-docs into master

2026-09-01 19:37:15 +00:00

kblack0610 commented

2026-09-01 19:33:49 +00:00

Owner

Rebased off current master. Original commit dbcb55e sat unshipped since 2026-07-27 (66 commits behind), stacked under the alloy branch.

Docs only. Verified: gungan health still exists (~/.local/bin/gungan:759); master README has no overlapping section.

Rebased off current master. Original commit dbcb55e sat unshipped since 2026-07-27 (66 commits behind), stacked under the alloy branch. Docs only. Verified: `gungan health` still exists (`~/.local/bin/gungan:759`); master README has no overlapping section.

kblack0610 added 1 commit

2026-09-01 19:33:49 +00:00

docs(asr): add dead-input troubleshooting to the asr-servers runbook

checks / fleet-roster (pull_request) Successful in 7s

Details

checks / kustomize-builds (pull_request) Successful in 7s

Details

d77d97bf60

Both ASR daemons return empty on silence by design, and the gungan client
turns that into "No speech detected" - so an unplugged mic and a working
one produce an identical symptom, and the obvious suspect is the daemons.

A debugging session was spent on the ASR stack while both daemons were
healthy and transcribing fixtures; the actual cause was that WirePlumber
had fallen back to a Focusrite Scarlett Solo with nothing plugged into its
XLR jack (-97.9 dB RMS, pure dither) after the previously configured
default source, a USB webcam, was unplugged. The Scarlett presents as a
perfectly healthy capture device while streaming silence.

Document the check-input-first order, the RMS reference points that make
dead input obvious, and how to repin the real device with `wpctl`.