How churchpresenter/stt works
STT is a real-time and batch speech-to-text platform with a browser control and display interface. The primary workflow captures or uploads audio, transcribes it, optionally translates it and synthesizes speech, then streams captions and stores session records for later review and export. The graph also includes the documented phase analysis, model management, file handling, and watchdog capabilities. Several subsystems are represented by their enclosing directory because their implementation files were not sampled; the README documents their roles, but not every internal call.
Main entry points: speech_to_text.py STT server · audio_capture.py Audio capture · llm_translate.py Translation engines · tts_backends.py Text-to-speech
Components 24
Capture and transcription
- STT server
speech_to_text.py - Audio capture
stt/audio_capture.py - File transcription
stt - Speech recognition
speech_to_text.py - VAD and sound detection
speech_to_text.py - Microphone calibration
stt/calibration.py
Translation and speech
- Translation engines
stt/llm_translate.py - Language catalogs
stt/nllb_catalog.py - Text-to-speech
stt/tts_backends.py
Review and session data
- Caption display
speech_to_text.py - Corrections and staging
stt - Service phase analysis
stt/service_phase.py - Sermon summaries
stt/sermon_summary.py - Session database
stt/session_meta.py - Backup file manager
stt
Models and operations
- Model manager
stt/downloads.py - Watchdog
stt/watchdog.py
Other components
- Operator
- Browser viewers
- Paired STT server
- Edge-TTS service
- Hugging Face
- Managed STT process
speech_to_text.py - SMB/NAS share
Connections 23
- Operator → STT server: operates
README.md - Browser viewers → Caption display: view captions
README.md - Audio capture → STT server: streams microphone audio
README.md - STT server → Audio capture: starts capture
README.md - STT server → File transcription: transcribes uploads
README.md - STT server → Speech recognition: transcribes audio
README.md - STT server → VAD and sound detection: filters and classifies
README.md - Operator → Microphone calibration: calibrates microphone
README.md - STT server → Translation engines: translates captions
README.md - Translation engines → Language catalogs: uses language codes
- STT server → Paired STT server: offloads translation
README.md - STT server → Text-to-speech: synthesizes speech
README.md - Text-to-speech → Edge-TTS service: uses cloud voices
README.md - STT server → Caption display: streams captions
README.md - Operator → Corrections and staging: reviews captions
README.md - STT server → Service phase analysis: detects service phases
README.md - Service phase analysis → Sermon summaries: provides sermon blocks
stt/sermon_summary.py - STT server → Session database: records session
README.md - Operator → Backup file manager: manages backups
README.md - Backup file manager → SMB/NAS share: delivers backups
README.md - Operator → Model manager: manages models
README.md - Model manager → Hugging Face: downloads models
README.md - Watchdog → Managed STT process: starts and restarts
stt/watchdog.py