How zachlatta/freeflow works
FreeFlow is a macOS menu-bar dictation and voice-editing app. The main workflow is shortcut activation, audio capture, optional app-context collection, provider transcription, context- and vocabulary-aware cleanup or selected-text editing, then insertion into the active app and history. The README also documents configurable shortcuts/providers, custom vocabulary, Edit Mode, and update support. Edges are limited to relationships visible in excerpts, the source index, or README; unsampled implementation details are not inferred.
Main entry points: AppState.swift Dictation coordinator · PostProcessingService.swift Cleanup and edit · SettingsView.swift App settings · HotkeyManager.swift Hotkey manager
Components 26
App interaction
- Menu bar UI
Sources/MenuBarView.swift - Dictation coordinator
Sources/AppState.swift
Shortcut and capture
- Shortcut settings
Sources/ShortcutComponents.swift - Shortcut bindings
Sources/ShortcutBinding.swift - Shortcut matcher
Sources/ShortcutCore/ShortcutMatcher.swift - Dictation session
Sources/ShortcutCore/DictationShortcutSessionController.swift - Hotkey manager
Sources/HotkeyManager.swift - Global shortcut backend
Sources/GlobalShortcutBackend.swift - Audio recorder
Sources/AudioRecorder.swift
Transcription and editing
- Realtime transcription
Sources/RealtimeTranscriptionService.swift - Provider transcription
Sources/TranscriptionService.swift - Cleanup and edit
Sources/PostProcessingService.swift - LLM request transport
Sources/LLMAPITransport.swift - Model configuration
Sources/ModelConfiguration.swift - Model cooldowns
Sources/LLMCooldownManager.swift
Context and vocabulary
- App context capture
Sources/AppContextService.swift - Custom vocabulary
Sources/AppState+AddVocabularyButton.swift
Settings and history
- Pipeline history record
Sources/PipelineHistoryItem.swift - Pipeline history store
Sources/PipelineHistoryStore.swift - App settings
Sources/SettingsView.swift - API key storage
Sources/KeychainStorage.swift - Update manager
Sources/UpdateManager.swift
Other components
- Dictation user
- Active text field
- Configured AI provider
- GitHub releases
Connections 31
- Dictation user → Menu bar UI: opens
- Menu bar UI → Dictation coordinator: uses state
Sources/App.swift - Dictation user → Shortcut settings: configures
README.md - Shortcut settings → Shortcut bindings: edits
Sources/ShortcutComponents.swift - Hotkey manager → Global shortcut backend: starts backend
Sources/HotkeyManager.swift - Hotkey manager → Shortcut matcher: matches events
Sources/HotkeyManager.swift - Shortcut matcher → Shortcut bindings: evaluates
Sources/ShortcutCore/ShortcutMatcher.swift - Dictation coordinator → Hotkey manager: starts monitoring
Sources/AppState.swift - Dictation coordinator → Dictation session: handles shortcut
Sources/AppState.swift - Dictation coordinator → Audio recorder: starts recording
Sources/AppState.swift - Dictation coordinator → App context capture: captures context
Sources/AppState.swift - Dictation coordinator → Realtime transcription: starts realtime
Sources/AppState.swift - Dictation coordinator → Provider transcription: requests fallback
Sources/AppState.swift - Provider transcription → Configured AI provider: sends audio
README.md - Dictation coordinator → Cleanup and edit: cleans transcript
Sources/AppState.swift - App context capture → Configured AI provider: requests inference
Sources/AppContextService.swift - Cleanup and edit → LLM request transport: sends requests
Sources/PostProcessingService.swift - Cleanup and edit → Model configuration: uses configuration
Sources/PostProcessingService.swift - Cleanup and edit → Model cooldowns: checks limits
Sources/PostProcessingService.swift - Cleanup and edit → Configured AI provider: requests cleanup
README.md - Dictation coordinator → Custom vocabulary: manages vocabulary
Sources/AppState+AddVocabularyButton.swift - Dictation user → Active text field: speaks into
README.md - Dictation coordinator → Active text field: pastes result
README.md - Dictation coordinator → Pipeline history record: records pipeline
Sources/AppState.swift - Dictation coordinator → Pipeline history store: persists history
Sources/AppState.swift - Pipeline history store → Pipeline history record: stores records
Sources/PipelineHistoryStore.swift - App settings → Dictation coordinator: configures
Sources/SettingsView.swift - App settings → Model configuration: selects models
Sources/SettingsView.swift - Dictation coordinator → API key storage: stores API key
Sources/AppState.swift - App settings → Update manager: manages updates
Sources/SettingsView.swift - Update manager → GitHub releases: checks releases
README.md