let-there-be-voicelocal voice for coding agents
ltbv banner

Install ltbv

Local speech for Claude Code and Codex on macOS.

Install

curl -fsSL https://raw.githubusercontent.com/arshlibruh-code/ltbv/main/install.sh | bash

Verify

ltbv doctor ltbv open

What the installer changes

~/.local/share/ltbvApplication checkout and locked Python environment.
~/.local/bin/ltbvCommand for opening, checking, updating, and removing ltbv.
Claude + CodexAdds managed hooks and preserves unrelated configuration.
settings backupsWritten beside the original files before hook changes.

Optional

OllamaCondenses long replies locally. Without it, ltbv uses deterministic fallback speech.
Browser audioLoad ~/.local/share/ltbv/browser-extension as an unpacked Arc or Chrome extension for YouTube ducking.

Manage

ltbv update ltbv uninstall
updateFast-forwards the installed checkout and reapplies managed hooks.
uninstallRemoves ltbv and its managed hook entries. Settings backups are retained.

Troubleshooting

command not foundOpen a new terminal. The installer adds ~/.local/bin to ~/.zprofile.
silentRun ltbv doctor, then check SHUT UP and quiet hours in the controller.
Ollama unavailableInstall and start Ollama, or choose none as the condense provider.
update refusedThe installed checkout has local changes. Commit or remove them before running ltbv update.

The installer is safe to rerun. Existing Claude and Codex settings are backed up before hook changes.