How getdictus/dictus-ios works
Dictus is an offline iOS dictation app with a system keyboard. The main workflow starts when a user invokes dictation from the keyboard: the app captures audio, runs an on-device speech engine, and hands text back for insertion. The app also manages speech models and provides optional Pro features including Smart Modes, searchable history, vocabulary, and voice notes. The README documents the cross-target App Group and audio bridge; source-index references support several internal module relationships. Unsampled implementation details are represented conservatively.
Main entry points: KeyboardViewController.swift Dictus keyboard · DictationCoordinator.swift Dictation coordinator · ContentView.swift Dictus app · ShareViewController.swift Voice note sharing
Components 19
Dictation
- Dictus app
DictusApp/ContentView.swift - Dictation coordinator
DictusApp/DictationCoordinator.swift - Audio capture
DictusApp/Audio/UnifiedAudioEngine.swift - Speech engines
DictusApp/Audio/ParakeetEngine.swift - Dictation handoff
DictusApp/DictationHandoff.swift - App Group
DictusCore/Sources/DictusCore/AppGroup.swift
Keyboard
- Dictus keyboard
DictusKeyboard/KeyboardViewController.swift - Text prediction
DictusKeyboard/TextPrediction/TextPredictionEngine.swift - Spellcheck trie
DictusKeyboard/TextPrediction/AOSPTrieEngine.swift
Models
- Model manager
DictusApp/Models/ModelManager.swift - Background downloads
DictusApp/Models/BackgroundModelDownloadService.swift
Pro Features
- Smart Modes
DictusCore/Sources/DictusCore/Polish/PolishPipeline.swift - Transcription history
DictusCore/Sources/DictusCore/History/TranscriptionHistoryStore.swift - Vocabulary
DictusCore/Sources/DictusCore/Vocabulary/VocabularyStore.swift - Voice note sharing
DictusShare/ShareViewController.swift - Voice note processing
DictusApp/VoiceNotes/VoiceNoteProcessor.swift - Pro subscription
DictusApp/Subscription/SubscriptionManager.swift
Other components
- User
- Share-sheet sender
Connections 20
- User → Dictus keyboard: starts dictation
README.md - Dictus keyboard → Dictus app: requests dictation
README.md - Dictus app → Dictation coordinator: coordinates
- Dictation coordinator → Audio capture: captures audio
DictusApp/DictationCoordinator.swift - Dictation coordinator → Speech engines: transcribes audio
DictusApp/DictationCoordinator.swift - Speech engines → Dictation handoff: produces text
- Dictation handoff → Dictus keyboard: returns text
README.md - Dictus keyboard → App Group: shares state
README.md - Dictus app → App Group: shares state
README.md - Dictus keyboard → Text prediction: requests suggestions
- Text prediction → Spellcheck trie: queries words
DictusKeyboard/TextPrediction/TextPredictionEngine.swift - Model manager → Background downloads: starts downloads
DictusApp/Models/ModelManager.swift - Model manager → Dictation coordinator: prepares models
DictusApp/Models/ModelManager.swift - User → Voice note sharing: shares voice note
README.md - Voice note sharing → App Group: queues note
DictusShare/ShareViewController.swift - Voice note sharing → Voice note processing: notifies app
- User → Smart Modes: selects Smart Mode
README.md - User → Transcription history: searches history
README.md - User → Vocabulary: teaches terms
README.md - User → Pro subscription: chooses Pro
README.md