Repository navigation
v0.10.0 — 99 languages, exact PID tracking, CUDA, stt-status
What's new
99-language coverage — model_aliases.json now covers all Whisper-supported languages with native i18n strings (listening/transcribing messages in the target language). Languages without a dedicated model fall back to multi + a language hint.
typing → transcribing — the in-progress notification text was renamed to better reflect what's happening.
Exact ffmpeg PID tracking — stt writes the ffmpeg PID to /tmp/stt.ffmpeg.pid and the Hyprland bindr kills that exact process, not a name pattern. Safer, no collateral kills.
Missed-release fallback — a naked-key bindr (modifier released before key) also stops the recording, so you no longer get orphaned ffmpeg processes from fast key presses.
stt-toggle — press once to start recording, press again to stop. Alternative to the hold-to-talk flow.
CUDA auto-detection — setup.sh runs nvidia-smi and pulls the CUDA speaches image automatically when an NVIDIA GPU is found.
Server readiness check — stt retries the speaches /models endpoint 3 times (1 s apart) before recording, avoiding "could not reach" errors when the container is still starting up.
--restart unless-stopped — the speaches container now survives reboots automatically.
stt-status — new diagnostic CLI:
$ stt-status
stt status
stt recording pid=12345
ffmpeg recording pid=12346
speaches online http://localhost:8000/v1
models 2 downloaded
Systran/faster-whisper-small
Systran/faster-whisper-small.hu
Shows stt state (recording / transcribing / idle / stale pid), ffmpeg instances with tracked/orphan classification, speaches server status, downloaded models, and warns on concurrent transcription requests.
Install
curl -fsSL https://stt.demo.land/setup.sh | bash