LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

voxtype

push-to-talk voice-to-text daemon for Linux desktops

TLDR

Run the dictation daemon
$ voxtype
copy
Download a model and check dependencies
$ voxtype setup --download
copy
Pick a transcription model interactively
$ voxtype setup model
copy
Start/stop recording from a compositor keybinding
$ voxtype record start
copy
$ voxtype record stop
copy
Transcribe an audio file
$ voxtype transcribe [recording.wav]
copy
Print daemon status as JSON (for Waybar)
$ voxtype status --format json --follow
copy

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

yay -S voxtype
copy
nix profile install nixpkgs#voxtype
copy

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.

SEE ALSO

wtype(1), ydotool(1), wl-copy(1)

RESOURCES

Copied to clipboard
Kai