How froloveee3/whisper-dictate works
Whisper Dictate is a Windows system-tray dictation app. Its main workflow is hotkey-triggered recording, transcription, and pasting the result into the focused application; settings, tray controls, autostart, and icon pinning support that workflow. The repository also includes an installer subsystem. Runtime relationships are grounded in the shown main.py calls and README; installer relationships use the shown installer/bootstrap excerpts. Other runtime modules are represented from the README structure and SOURCE INDEX, so unsampled internal calls are omitted.
Main entry points: main.py App coordinator · gpu.py GPU detection · env.py Python environment · installer.py Installer coordinator
Components 21
Dictation runtime
- App coordinator
main.py - Audio capture
app/core/audio.py - Whisper lifecycle
app/core/transcribe.py - Clipboard and paste
main.py - Configuration
app/config.py
Tray and settings
- Tray interface
app/ui/tray.py - Settings dialog
app/ui/settings.py - Tray pinning
app/ui/pin.py
Windows integration
- Global hotkeys
app/system/hotkeys.py - Autostart
app/system/autostart.py - Windows utilities
app/system/winutils.py
Installer
- Installer coordinator
installer.py - Python environment
bootstrap/env.py - GPU detection
bootstrap/gpu.py - App deployment
bootstrap/deploy.py - Install paths
bootstrap/paths.py - Installer output
bootstrap/console.py
Other components
- User
- Focused app
- Microphone
- Whisper engine
Connections 26
- User → Global hotkeys: presses
README.md - Global hotkeys → App coordinator: dispatches callbacks
main.py - App coordinator → Global hotkeys: registers
main.py - App coordinator → Audio capture: starts and stops
main.py - Microphone → Audio capture: supplies audio
- App coordinator → Whisper lifecycle: preloads and runs
main.py - Whisper lifecycle → Whisper engine: loads and transcribes
README.md - App coordinator → Clipboard and paste: copies and pastes
main.py - Clipboard and paste → Focused app: pastes text
README.md - App coordinator → Configuration: loads and saves
main.py - App coordinator → Tray interface: updates icon and menu
main.py - App coordinator → Settings dialog: opens dialog
main.py - Settings dialog → App coordinator: saves settings callback
main.py - App coordinator → Autostart: checks and toggles
main.py - App coordinator → Tray pinning: promotes icon
main.py - App coordinator → Windows utilities: configures process
main.py - Installer coordinator → Python environment: probes and installs
installer.py - Installer coordinator → GPU detection: detects and installs torch
installer.py - Installer coordinator → App deployment: deploys and launches
installer.py - Python environment → Install paths: uses paths
bootstrap/env.py - GPU detection → Python environment: uses package notices
bootstrap/gpu.py - GPU detection → Install paths: uses pip path
bootstrap/gpu.py - App deployment → Install paths: uses install paths
bootstrap/deploy.py - Python environment → Installer output: reports progress
bootstrap/env.py - GPU detection → Installer output: reports progress
bootstrap/gpu.py - App deployment → Installer output: reports deployment
bootstrap/deploy.py