Dictating
Start a Recording, speak, stop, and the Transcript lands at your cursor. This page covers the gestures on each platform, what the capsule is telling you, and how to get your words back when a paste doesn't land.
Windows: hold Ctrl Win
| Do this | What happens |
|---|---|
| Hold Ctrl Win and speak | Recording runs while you hold the keys. Release them to stop and transcribe. |
| Double-tap Ctrl Win | Hands-free: the Recording keeps going after you let go. Press Ctrl Win again to stop. |
| Esc | Cancels the Recording. Nothing is transcribed or pasted. |
| Press another key while holding | Also cancels, so a Ctrl Win shortcut you meant for Windows doesn't turn into a Recording. |
A quick tap shorter than about a third of a second isn't a Recording. Voisu starts listening on the first press, so the start of your sentence isn't clipped while it decides.
Mac: hold Control Option
The Mac works like Windows with a different chord: hold Control Option and speak, let go to transcribe, double-tap for hands-free, and Esc cancels. You can switch to Option ⌘ or Right ⌘ in Settings. Voisu needs the Accessibility and Input Monitoring permissions for this; the Mac guide shows how to allow them.
Linux: press, speak, press
On Linux the Trigger Key is the shortcut your desktop approved for Voisu (or the bind setup made on Hyprland, or the custom shortcut you made on X11). It doesn't need holding:
Press the Trigger Key. Recording starts.
Speak as long as you like.
Press the Trigger Key again. Voisu transcribes and delivers.
The same thing works from a terminal or a script with voisu toggle. voisu shortcut shows which key your desktop approved.
The capsule
The Overlay is a small capsule near the bottom of your screen. It never takes focus, so it can't steal your cursor.
- RecordingLive level bars follow your voice. On Windows, a green dot at the left means hands-free.
- ProcessingA light sweeps across the bars while the providers finish and Voisu builds the Transcript.
- DeliveredYour text appears, a check mark shows for a moment, and the capsule goes away.
- ProblemA short message says what went wrong, such as no microphone, nothing heard, or a paste that couldn't land.
The capsule is optional on Linux: it's the voisu-overlay package on Fedora and the overlay@voisu.app GNOME Shell extension on Ubuntu. On X11 the same feedback arrives as desktop notifications. On Windows the tray's Preview overlay item shows it without recording.
On Windows you can make the capsule smaller or larger under Overlay size in Settings.
Where the text goes
Windows. Voisu pastes into the window that had focus when you started the Recording, even if you clicked somewhere else while talking. It then puts your previous clipboard back. Terminals get the paste shortcut they expect: Ctrl Shift V for Windows Terminal, Alacritty and WezTerm, Shift Insert for the classic console, PuTTY, Git Bash and ConEmu. Voisu's paste is kept out of Windows clipboard history (Win V).
Linux. Voisu always puts the Transcript on the clipboard first. The Delivery setting decides what happens next:
| Delivery | Behaviour |
|---|---|
paste | The default. Voisu pastes into the window you're typing in. On Hyprland it presses your paste shortcut; on KDE Plasma and GNOME it goes through the desktop's RemoteDesktop permission, which your desktop asks for once. |
copy | Voisu only copies. You paste with Ctrl V wherever you like. |
Change it in the Settings tab of voisu, or with voisu delivery paste or voisu delivery copy. Settings saved by older versions (type, clipboard, guarded) keep working.
On Windows, turn off Paste automatically in Settings to have Voisu only put the Transcript on your clipboard, without pressing any keys for you.
Your last Transcript
When a paste doesn't land, the words aren't lost.
- Windows: open Settings… from the tray. The Last Transcript card on the Overview tab shows your most recent Transcript with a Copy button. It's held in memory only and is gone when Voisu quits.
- Linux: the Transcript is usually still on your clipboard, so paste it with Ctrl V (or Ctrl Shift V in a terminal).
voisu historylists recent Recordings, newest first, with the start of each Transcript, andvoisu history --jsongives the full text.
Speaking tips
- Speak naturally, in full sentences. Voisu adds punctuation and capitals for you.
- On Linux you can also say marks the way you'd read them: “dash dash”, “slash”, “quote … unquote”, “new paragraph”, or “first … second …” for a numbered list.
- Teach Voisu names and jargon it gets wrong. On Windows, add them under Boost words in Settings. On Linux, use
voisu dictionary add <term>(see Settings).