How cjpais/handy works
Handy is a cross-platform desktop speech-to-text app designed to transcribe speech locally and paste the result into the active application. Its primary workflow is shortcut activation, audio capture, speech processing, then text insertion; settings, model management, history, onboarding, and optional post-processing support that flow. The README documents the user-facing capabilities; source excerpts and the index substantiate selected internal connections, while unsampled subsystem links are omitted or marked unverified.
Main entry points: actions.rs Transcription actions · App.tsx App shell · index.ts Settings interface · handler.rs Shortcut handler
Components 22
Desktop interface
- App shell
src/App.tsx - Onboarding
src/components/onboarding/OnboardingFlow.tsx - Recording overlay
src/overlay/RecordingOverlay.tsx - Settings interface
src/components/settings/index.ts
Recording and input
- Shortcut handler
src-tauri/src/shortcut/handler.rs - Transcription actions
src-tauri/src/actions.rs - Audio recording
src-tauri/src/managers/audio.rs - Text insertion
src-tauri/src/clipboard.rs
Speech processing
- Transcription coordinator
src-tauri/src/transcription_coordinator.rs - Transcription engine
src-tauri/src/managers/transcription.rs - Voice activity detection
src-tauri/src/audio_toolkit/vad - Model management
src-tauri/src/managers/model.rs - Model catalog
src-tauri/src/catalog/mod.rs
Settings and history
- Settings state
src/stores/settingsStore.ts - Settings persistence
src-tauri/src/settings.rs - Transcript history
src-tauri/src/managers/history.rs
Optional capabilities
- LLM post-processing
src-tauri/src/llm_client.rs - Transcription hook
src-tauri/src/transcription_hook.rs - CLI controls
src-tauri/src/cli.rs
Other components
- User
- Active application
- LLM provider
Connections 21
- User → Shortcut handler: activates
README.md - Shortcut handler → Transcription actions: dispatches
src-tauri/src/shortcut/handler.rs - Transcription actions → Audio recording: starts recording
src-tauri/src/actions.rs - Transcription actions → Transcription coordinator: coordinates
src-tauri/src/transcription_coordinator.rs - Transcription actions → Transcription engine: transcribes
src-tauri/src/actions.rs - Transcription actions → Voice activity detection: uses VAD
src-tauri/src/actions.rs - Transcription actions → Model management: selects model
src-tauri/src/actions.rs - Transcription actions → Transcript history: saves transcript
src-tauri/src/actions.rs - Transcription actions → Text insertion: inserts text
README.md - Text insertion → Active application: pastes into
README.md - User → App shell: configures
- App shell → Onboarding: presents
src/App.tsx - App shell → Settings interface: shows settings
src/App.tsx - Settings interface → Settings state: updates
- Settings state → Settings persistence: reads and writes
- User → Recording overlay: views status
- Model management → Model catalog: uses catalog
- Transcription actions → LLM post-processing: post-processes text
src-tauri/src/actions.rs - LLM post-processing → LLM provider: sends request
src-tauri/src/llm_client.rs - Transcription actions → Transcription hook: rewrites text
README.md - User → CLI controls: controls app
README.md