How davimatosms/arara-voice works
Arara is a desktop voice-dictation app for Brazilian Portuguese: the user triggers recording with a global shortcut, speaks, reviews live text, then receives a locally transcribed result pasted at the cursor and saved in local history. The core separates audio capture and speech detection from transcription and delivery; app screens provide onboarding, settings, dictionary/history access, themes, and updates. README and source-index references establish the main workflow and module relationships; unsampled implementation details are not expanded into additional call paths.
Main entry points: DefaultDictationEngine.java Dictation engine · AraraCore.java Core assembly · SettingsPage.java Settings screen · Main.java App startup
Components 24
Desktop app
- App startup
app/src/main/java/br/arara/app/Main.java - First-run guide
app/src/main/java/br/arara/app/Onboarding.java - Settings screen
app/src/main/java/br/arara/app/SettingsPage.java - Recording popup
app/src/main/java/br/arara/app/RecordingPopup.java - Themes and macaw
app/src/main/java/br/arara/app/Theme.java - History screen
app/src/main/java/br/arara/app/HistoryPage.java - Dictionary screen
app/src/main/java/br/arara/app/DictionaryPage.java
Dictation runtime
- Global shortcut
core/src/main/java/br/arara/core/GlobalHotkey.java - Core assembly
core/src/main/java/br/arara/core/AraraCore.java - Dictation engine
core/src/main/java/br/arara/core/DefaultDictationEngine.java - Mic and VAD
core/src/main/java/br/arara/core/Microphone.java - Whisper transcription
core/src/main/java/br/arara/core/WhisperTranscriber.java - Live preview
core/src/main/java/br/arara/core/DefaultDictationEngine.java - Clipboard paste
core/src/main/java/br/arara/core/ClipboardPaster.java
Local data
- Correction dictionary
core/src/main/java/br/arara/core/JsonDictionaryStore.java - Dictation history
core/src/main/java/br/arara/core/JsonlHistoryStore.java - Settings store
core/src/main/java/br/arara/core/JsonSettingsStore.java
Setup and updates
- Model download
app/src/main/java/br/arara/app/ModelDownload.java - Model host
- Update checker
core/src/main/java/br/arara/core/UpdateChecker.java - Update interface
app/src/main/java/br/arara/app/UpdateUi.java - Version manifest
Other components
- User
- Focused app
Connections 28
- User → Global shortcut: presses
README.md - Global shortcut → Dictation engine: toggles
- Dictation engine → Mic and VAD: captures speech
core/src/main/java/br/arara/core/DefaultDictationEngine.java - Dictation engine → Whisper transcription: transcribes
core/src/main/java/br/arara/core/DefaultDictationEngine.java - Dictation engine → Live preview: emits live text
core/src/main/java/br/arara/core/DefaultDictationEngine.java - Dictation engine → Correction dictionary: uses terms
core/src/main/java/br/arara/core/DefaultDictationEngine.java - Dictation engine → Dictation history: saves result
core/src/main/java/br/arara/core/DefaultDictationEngine.java - Dictation engine → Clipboard paste: pastes text
core/src/main/java/br/arara/core/DefaultDictationEngine.java - Clipboard paste → Focused app: inserts text
README.md - Core assembly → Dictation engine: creates
core/src/main/java/br/arara/core/AraraCore.java - Core assembly → Global shortcut: registers
core/src/main/java/br/arara/core/AraraCore.java - Core assembly → Settings store: loads and saves
core/src/main/java/br/arara/core/AraraCore.java - Core assembly → Dictation history: opens store
core/src/main/java/br/arara/core/AraraCore.java - Core assembly → Correction dictionary: opens store
core/src/main/java/br/arara/core/AraraCore.java - Dictation engine → Recording popup: notifies
- App startup → Core assembly: starts
app/src/main/java/br/arara/app/Main.java - App startup → First-run guide: opens first run
app/src/main/java/br/arara/app/Main.java - App startup → Settings screen: opens
app/src/main/java/br/arara/app/Main.java - Settings screen → Settings store: updates preferences
app/src/main/java/br/arara/app/SettingsPage.java - Settings screen → History screen: opens
app/src/main/java/br/arara/app/SettingsPage.java - History screen → Dictation history: reads entries
- Dictionary screen → Correction dictionary: edits terms
- Settings screen → Themes and macaw: selects appearance
app/src/main/java/br/arara/app/SettingsPage.java - First-run guide → Model download: requests model
app/src/main/java/br/arara/app/Onboarding.java - Model download → Model host: downloads model
README.md - Settings screen → Update checker: checks updates
app/src/main/java/br/arara/app/SettingsPage.java - Update checker → Version manifest: fetches version
core/src/main/java/br/arara/core/UpdateChecker.java - Update checker → Update interface: reports update
app/src/main/java/br/arara/app/UpdateUi.java