§ First run
First run on Linux
Open Dettivo from the launcher. If something is missing, three screens walk you through it: Keys, Models and Try it. After that the app opens on Home, and holding F9 dictates into any window.
Who this is for
New installs, right after dettivo setup. The screens only appear when something is missing, so you can skip them by writing config.toml yourself.
The three screens
- 01
Keys
Shows the bindings
dettivo setupwrote and confirms your key press live. Hold F9 and the screen shows your microphone level.First run › Keys
- 02
Models
Recommends the speech model that transcribes your language best, with its word error rate beside it, and downloads it. Every file is checked against a pinned checksum, and an interrupted download picks up where it stopped.
First run › Models
- 03
Try it
Hold F9, say a sentence, let go. The words land on the screen with the backend that typed them and how long the stop took.
First run › Try it
A model for your language
The Models screen reads [dictation] language, or your system locale while that is auto, and preselects the model the catalogue ranks first for it. The ranks come from a recorded FLEURS run over eight languages. A model you already selected never changes.
dettivo speech providers --language de prints the same ranking in a terminal, with each word error rate and which models are already on disk.
Terminal
bash
$ dettivo speech providers --language de
For German, parakeet-ultra is recommended (WER 4.2), parakeet-v3 is close (4.8), large-v3-turbo is close (5.2).
1 parakeet/parakeet-ultra WER 4.2
2 parakeet/parakeet-v3 WER 4.8 ready
3 whisper/large-v3-turbo WER 5.2 readyAfter first run
Home lists today's dictations, the engines and which agents are connected. History and Meetings sit in the sidebar. Settings edits the same config.toml you can open in an editor.
When something looks off, run dettivo doctor. It checks the service, the socket, the configuration, every engine and its backend, the insertion chain and the hotkeys, then names what is missing.
Free and open source · GPL-3.0
Dettivo for Linux 0.5.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.