Repository navigation
v1.5.2 — the driver actually appears
Reported as: setup says BlackHole installed, and Sound settings has no BlackHole in it.
Both were true. The driver was installed. It was never published.
A HAL driver is a file in /Library/Audio/Plug-Ins/HAL, and CoreAudio only offers it as a device once coreaudiod re-reads that directory. That restart was in the code as sudo -n killall coreaudiod — non-interactive sudo, which fails rather than ask for a password, so it failed on every machine that asks for one. It failed quietly, both callers discarded the result, and the driver sat on disk unpublished while the install reported success.
Worth stating plainly why this looked fine in development: sudo -n fails on the development machine too. BlackHole worked there because a later reboot published it. The install step never worked for anybody.
The restart now runs inside the installer's own administrator prompt — one password rather than two, since two prompts for one operation is how people grant the first and cancel the second, which produces exactly the state reported. It is braced so a failed install does not restart the machine's audio.
The advice was wrong as well as absent. It said restarting the app would settle it; the app is not what has to re-read /Library. The dialog now separates a driver on disk that is one command away from one that never installed, and points at echoai-helper setup instead of a script path that someone who installed the wheel does not have.
If you hit this on 1.5.1, sudo killall coreaudiod fixes it without upgrading — though upgrading is better, since setup will otherwise leave the next machine in the same state.
Also
Wear headphones if you record your microphone. Played through speakers, the far end lands in your own track: on a measured session the microphone came on 234 seconds in and 5 of 21 "You" turns after that were the far end repeated back. Meeting apps cancel echo on the stream they send, inside themselves — this app opens the input device separately and gets the raw microphone, which that cancellation never touched and could not. Now documented under Known limitations.
uv tool install --force --refresh echoai-helper
413 tests.
Full changelog: v1.5.1...v1.5.2