How kitlangton/hex works
Hex is a legacy macOS voice-dictation app: users trigger recording with a global hotkey, speak, and have the transcription pasted into the active application. Its runtime also includes model selection and downloads, permissions, settings, transcript history, and word remappings. The sampled code shows recording and transcript persistence calls; the README documents the end-to-end workflow and supported transcription engines. Several substantial modules are indexed but unsampled, so uncertain internal links are omitted.
Main entry points: TranscriptionFeature.swift Transcription flow · SettingsFeature.swift Settings feature · TranscriptionClient.swift Transcription engines · KeyEventMonitorClient.swift Global key monitor
Components 23
App workflow
- App lifecycle
Hex/App/HexAppDelegate.swift - App feature
Hex/Features/App/AppFeature.swift - Transcription flow
Hex/Features/Transcription/TranscriptionFeature.swift - Recording indicator
Hex/Features/Transcription/TranscriptionIndicatorView.swift
Capture and transcription
- Global key monitor
Hex/Clients/KeyEventMonitorClient.swift - Hotkey processor
HexCore/Sources/HexCore/Logic/HotKeyProcessor.swift - Recording client
Hex/Clients/RecordingClient.swift - Fast audio capture
Hex/Clients/SuperFastCaptureController.swift - Transcription engines
Hex/Clients/TranscriptionClient.swift - Parakeet engine
Hex/Clients/ParakeetClient.swift - Audio clip preparation
Hex/Clients/ParakeetClipPreparer.swift - Paste and clipboard
Hex/Clients/PasteboardClient.swift
Settings and models
- Settings feature
Hex/Features/Settings/SettingsFeature.swift - Settings state
HexCore/Sources/HexCore/Settings/HexSettings.swift - Model downloads
Hex/Features/Settings/ModelDownload/ModelDownloadFeature.swift - Model matching
HexCore/Sources/HexCore/Logic/ModelPatternMatcher.swift
Permissions and history
- Permission client
HexCore/Sources/HexCore/PermissionClient/PermissionClient+Live.swift - History feature
Hex/Features/History/HistoryFeature.swift - Transcript records
HexCore/Sources/HexCore/Models/TranscriptionHistory.swift - Transcript persistence
HexCore/Sources/HexCore/TranscriptPersistenceClient/TranscriptPersistenceClient.swift - Word remappings
Hex/Features/Remappings/WordRemappingsView.swift
Other components
- Mac user
- Active application
Connections 21
- Mac user → Global key monitor: presses hotkey
- Global key monitor → Transcription flow: delivers keys
Hex/Features/Transcription/TranscriptionFeature.swift - Transcription flow → Hotkey processor: processes events
Hex/Features/Transcription/TranscriptionFeature.swift - Transcription flow → Recording client: controls recording
Hex/Features/Transcription/TranscriptionFeature.swift - Recording client → Fast audio capture: uses capture
Hex/Clients/RecordingClient.swift - Transcription flow → Transcription engines: transcribes audio
- Transcription engines → Parakeet engine: dispatches engine
Hex/Clients/TranscriptionClient.swift - Transcription engines → Audio clip preparation: prepares audio
Hex/Clients/TranscriptionClient.swift - Transcription flow → Paste and clipboard: pastes result
- Paste and clipboard → Active application: pastes text
- App lifecycle → App feature: starts lifecycle
Hex/App/HexApp.swift - Settings feature → Model downloads: fetches models
Hex/Features/Settings/SettingsFeature.swift - Model downloads → Model matching: matches models
Hex/Features/Settings/ModelDownload/ModelDownloadFeature.swift - Settings feature → Settings state: updates settings
Hex/Features/Settings/SettingsFeature.swift - Transcription flow → Settings state: reads preferences
Hex/Features/Transcription/TranscriptionFeature.swift - Transcription flow → Transcript persistence: saves transcript
Hex/Features/Transcription/TranscriptionFeature.swift - History feature → Transcript records: manages records
Hex/Features/History/HistoryFeature.swift - Transcription flow → Transcript records: stores history data
Hex/Features/Transcription/TranscriptionFeature.swift - Settings feature → Permission client: configures access
- Settings feature → Word remappings: edits remappings
- Transcription flow → Recording indicator: updates display
Hex/Features/Transcription/TranscriptionFeature.swift