How fjenn/wispr-bro works
Wispr Bro is a local-first macOS dictation app. The main user workflow is to invoke a shortcut, record speech, transcribe it locally, clean the text, and insert it into the active app; the README describes this flow, while the sampled hotkey engine shows dispatch into the transcription coordinator. Other documented product branches include model management, writing aids, history, context awareness, settings, synchronization, and background updates. Several backend stages are unsampled, so their internal links are marked unverified rather than inferred as observed calls.
Main entry points: App.tsx App shell · llm Text cleanup · transcription.rs Speech transcription · transcription_coordinator.rs Transcription coordinator
Components 23
App interaction
- App shell
src/App.tsx - Tauri bindings
src/bindings.ts - Settings UI
src/hooks/useSettings.ts - Shortcut engine
src-tauri/src/fork/shortcut/engine.rs
Dictation pipeline
- Transcription coordinator
src-tauri/src/transcription_coordinator.rs - Audio capture
src-tauri/crates/wb-handy-recorder/src/capture/engine.rs - Speech transcription
src-tauri/src/managers/transcription.rs - Audio processing
src-tauri/src/audio_toolkit
Writing tools
- Text cleanup
src-tauri/src/fork/llm - Provider cleanup
src-tauri/src/llm_client.rs - Text insertion
src-tauri/src/fork/insert - Dictionary
src-tauri/src/fork/dictionary - Snippets
src-tauri/src/fork/snippets - Context awareness
src-tauri/src/fork/context
Local state
- History
src-tauri/src/fork/db - Model management
src-tauri/src/fork/models - Settings storage
src-tauri/src/settings.rs - Sync
src-tauri/src/fork/sync
Platform services
- App updates
src-tauri/src/fork/update
Other components
- User
- Active app
- On-device models
- Signed release feed
Connections 22
- User → Shortcut engine: invokes
- Shortcut engine → Transcription coordinator: dispatches commands
src-tauri/src/fork/shortcut/engine.rs - User → Audio capture: speaks
- Transcription coordinator → Audio capture: starts capture
- Audio capture → Speech transcription: provides audio
- Speech transcription → Audio processing: processes audio
- Speech transcription → Text cleanup: produces transcript
- Text cleanup → Provider cleanup: uses provider
src-tauri/src/llm_client.rs - Text cleanup → On-device models: uses local models
- Transcription coordinator → Text insertion: delivers text
- Text insertion → Active app: inserts text
- App shell → Tauri bindings: invokes commands
src/App.tsx - Tauri bindings → Settings UI: serves settings
src/hooks/useSettings.ts - Settings UI → Settings storage: reads and updates
- Text cleanup → Dictionary: uses vocabulary
- Text cleanup → Context awareness: uses context
- App shell → Snippets: offers snippets
- Speech transcription → History: stores results
- App shell → Model management: manages models
- App shell → Sync: supports sync
- App shell → App updates: checks updates
- App updates → Signed release feed: checks signed feed