Development · Data · AI

Voice-controlled local teleprompter

Teleprompter that scrolls at the pace of the voice using local Whisper, without sending data to the cloud.

1 star2026role: autor únicostatus: activo
procedural cover — real screenshots pendingProcedural cover for the project Voice-controlled local teleprompter.

01 Summary

Desktop teleprompter that synchronizes script scrolling with the speaker's voice in real time, featuring 100% offline processing. Captures microphone audio, transcribes it locally using faster-whisper on an NVIDIA GPU (CUDA), and aligns the transcript with the script via a deterministic matcher with fuzzy matching, sending the scroll position to the frontend over WebSocket from a FastAPI backend. Includes a classic auto-scroll mode, scene directives ignored by the speech recognizer, and a stealth mode running as a native app built with pywebview.

02 Highlights

  • Local speech recognition using CUDA-accelerated faster-whisper, configurable via environment variables (model, device, precision).
  • Deterministic script-to-transcript alignment algorithm with Unicode normalization and Levenshtein fuzzy matching ≤ 1.
  • FastAPI backend with a custom WebSocket protocol that orchestrates audio capture, STT, and matcher in real time.
  • Stealth mode as a native app via pywebview, featuring always-on-top behavior and interaction blocking.
  • Vanilla HTML/CSS/JS frontend with auto-scroll, bracketed scene directives, and keyboard shortcuts.

03 Screenshots