voxtype
push-to-talk voice-to-text daemon for Linux desktops
TLDR
SYNOPSIS
voxtype [options] [command]
DESCRIPTION
voxtype is an offline-first voice-to-text tool for Wayland and X11. Hold a hotkey (default ScrollLock), speak, release, and the transcript is typed at the cursor (or copied to the clipboard). Omarchy ships it as the optional dictation stack (*Install > AI > Dictation*).Transcription runs locally. Engines include Whisper (whisper.cpp), Parakeet, Moonshine, SenseVoice, Paraformer, Dolphin, and Omnilingual. Output goes through wtype on Wayland, with dotool / ydotool / clipboard fallbacks. Compositor bindings should call voxtype record start / stop (or toggle) rather than relying on the built-in evdev hotkey.
PARAMETERS
-c, --config FILE
Config path (default ~/.config/voxtype/config.toml).--model MODEL
Override the transcription model.--engine ENGINE
Override the engine (whisper, parakeet, moonshine, sensevoice, paraformer, dolphin, omnilingual).--hotkey KEY
Override the built-in hotkey.--toggle
Press once to start recording, again to stop.--clipboard / --paste
Force clipboard, or clipboard plus simulated Ctrl+V.-v, -q
Increase verbosity, or quiet (errors only).
CONFIGURATION
~/.config/voxtype/config.toml
Hotkey, audio device, engine/model, output mode (type, clipboard, paste), replacements, and post-process command. voxtype configure (where shipped) edits this interactively.
COMMANDS
daemon
Run in the foreground (default when no command is given).setup [--download | systemd | waybar | model | gpu | onnx]
Dependency checks, model download, systemd user unit, Waybar snippet, GPU/ONNX switching.record start | stop | toggle
Control recording from compositor keybindings or scripts.transcribe file
Transcribe an audio file.status
Daemon state for bars. --format json, --follow, --extended.config
Show the current configuration.meeting start | stop | status | export | list | summarize
Continuous meeting transcription and export (Markdown, JSON, SRT, VTT).
INSTALL
CAVEATS
Needs PipeWire or PulseAudio, a typing backend (wtype recommended on Wayland), and a downloaded model. Built-in evdev hotkeys require membership in the input group; compositor bindings do not. wtype does not work on GNOME/KDE Wayland (dotool/ydotool fallback). GPU and ONNX engines use separate binaries/packages.
