§ When something breaks
Troubleshooting on Linux
Start with dettivo doctor. It checks the service, the socket, the configuration, every engine and its backend, the insertion chain, the hotkeys, the history store and the pill, and names what is missing.
Who this is for
Anyone whose keys, insertion, models or meetings are not doing what they should.
First checks
Terminal
bash
dettivo doctor # the whole picture
dettivo setup omarchy --check # is the binding snippet loaded?
dettivo insert target # which insertion backend runs next, and why
dettivo speech status # every model and its state
dettivo config validate # the key and line that do not parse
journalctl --user -u dettivod # the daemon logSymptoms
F9 does nothing
Run dettivo setup omarchy --check, or the same with your compositor's name, to see whether your main config loads the binding snippet. dettivo hotkeys status shows the backend inside the daemon. Running the setup line again fixes a missing include.
The text arrived as a paste, or not at all
Some windows refuse the virtual keyboard, and Dettivo pastes into those. dettivo insert target shows the focused window, the backend the next insertion will use and why the others are out. The pill's error state says what failed and what to do next.
A model shows as quarantined or missing
A file that fails its checksum is moved aside. dettivo speech status lists every model, and dettivo speech download --model <id> --wait fetches it again.
My settings stopped applying
dettivo config validate names the key and line that do not parse. The daemon keeps running on defaults until the file is fixed.
A meeting will not start
Meetings need a Whisper model, because the Parakeet models are for dictation. The first meeting also asks you to acknowledge the recording notice. The message names whichever one is in the way.
Where are the logs?
journalctl --user -u dettivod. No log level writes transcript text or audio.
Free and open source · GPL-3.0
Dettivo for Linux 0.2.0 is on GitHub.
The release page has the pacman package and its checksum. Bug reports go to the issue tracker. On a Mac? The native Mac app does all of this with Apple Silicon models.