§ Linux install
Install Dettivo on Linux
Download the pacman package from the latest GitHub release, then three commands put Dettivo on an Omarchy machine: pacman installs the package, systemctl enables the daemon, and dettivo setup omarchy binds the keys and adds the bar plugin and the recording pill.
Who this is for
Anyone on an x86_64 Arch Linux, Omarchy or Arch-based machine. On plain Hyprland, Sway or Niri the package is the same and only the setup line changes. On other distributions, build from source.
Install from the GitHub release
Omarchy · Arch
bash
sudo pacman -U dettivo-bin-*-x86_64.pkg.tar.zst
systemctl --user enable --now dettivod.socket
dettivo setup omarchyWhat you need
An x86_64 Arch Linux or Omarchy machine with Qt 6.8 or newer and PipeWire, in a Wayland session. The package is built for Arch and Arch-based distributions.
On Fedora, openSUSE, Ubuntu, Debian and other distributions with Qt 6.8 or newer, build from source with the steps in the repository README. That route has not been tested outside Arch yet, and a report of what worked helps.
A GPU is optional. The engines use Vulkan when a driver is installed and fall back to the CPU with smaller default models. Run dettivo doctor after the install to see which tier your machine is on and whether anything is missing.
Disk space for the models you pick. They are not in the package. First run downloads them.
Other desktops
Replace the last line with the one for your compositor. Each writes a binding snippet for the same four actions.
| Desktop | Setup | What happens |
|---|---|---|
| Omarchy | dettivo setup omarchy | Binds the keys, installs the bar plugin and the pill, reloads Hyprland and the bar. |
| Hyprland | dettivo setup hyprland | Writes the snippet and prints the include line to add. |
| Sway | dettivo setup sway | Writes the snippet and prints the include line to add. |
| Niri | dettivo setup niri | Same, without release bindings. The toggle chord does the holding. |
| GNOME, KDE | nothing to run | The daemon binds the keys through the GlobalShortcuts portal. |
Checking the package by hand
Every release has a .sha256 file next to the package. Download both, run sha256sum --check dettivo-bin-*.pkg.tar.zst.sha256, then sudo pacman -U the file. It is the same package CI installs and tests in a clean Arch container before the release goes out.
Where things live
Your home directory
- ~/.config/dettivo/config.toml
- Every setting. The app, the bar and the CLI all edit this one file, and your comments survive.
- ~/.local/share/dettivo/models/
- Downloaded models, each with a manifest of the checksum it was verified against.
- dettivod.socket
- The systemd user socket. The daemon starts on the first request and needs no autostart entry.
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.