shijin384/voxtral-dictate — explained in plain English
Analysis updated 2026-05-18
Dictate text into a terminal, editor, or browser using a keyboard shortcut.
Replace selected text with a spoken transcript at the cursor.
See recording and transcribing status through a GNOME overlay indicator.
| shijin384/voxtral-dictate | 0marildo/imago | 0xdfi/glm-5.2-1m-4x-dgx-spark | |
|---|---|---|---|
| Stars | 3 | 3 | 3 |
| Language | Python | Python | Python |
| Setup difficulty | moderate | easy | hard |
| Complexity | 3/5 | 2/5 | 5/5 |
| Audience | general | general | researcher |
Figures from each repo's GitHub metadata at analysis time.
Requires Ubuntu with GNOME on Wayland, a microphone, and a Mistral API key.
Voxtral-dictate is a voice dictation tool for Linux that lets a person type by speaking, using AI transcription from Mistral's Voxtral model. It is built specifically for Ubuntu running the GNOME desktop on Wayland, and it works inside any application, whether that is a terminal, a text editor, or a web browser. The way it works is simple in practice: pressing a keyboard shortcut, Alt+T by default, starts recording from the microphone, and pressing it again stops the recording. The recorded audio is then sent to the Voxtral transcription service, the resulting text is copied to the clipboard, and a tool called ydotool simulates a paste keystroke so the transcript appears right at the cursor. If text was already selected when the shortcut was pressed, the transcript replaces it. A small overlay bubble, added through a GNOME Shell extension, shows a red dot while recording and a yellow dot while transcribing so the user can see the current state. Setting it up requires a Linux system running Ubuntu with GNOME on Wayland, a microphone, and an API key from Mistral for using the Voxtral transcription models. Installation is done through a setup script that installs several required packages, configures permissions needed for simulating keystrokes, asks for the Mistral API key, installs the GNOME Shell extension, and registers the chosen keyboard shortcut. A one time log out and back in is needed afterward for the new permissions and extension to take effect. The API key is stored securely in the GNOME keyring rather than as plain text, though a plaintext fallback exists in the config file if no keyring entry is set. Settings can be adjusted in a config file, including which Voxtral model to use, whether to force a specific spoken language, a maximum recording duration, and which paste keystroke combination to use, since some terminal and desktop apps expect different paste shortcuts.
Voxtral-dictate lets you dictate text into any Linux app with a keyboard shortcut, using Mistral's Voxtral AI to transcribe your speech.
Mainly Python. The stack also includes Python, GNOME Shell, Wayland.
The README does not state a license for this code.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly general.
This repo across BitVibe Labs
double-check against the repo, no cap.