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 thisWhat happens
Hold Ctrl Win and speakRecording runs while you hold the keys. Release them to stop and transcribe.
Double-tap Ctrl WinHands-free: the Recording keeps going after you let go. Press Ctrl Win again to stop.
EscCancels the Recording. Nothing is transcribed or pasted.
Press another key while holdingAlso 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:

  1. Press the Trigger Key. Recording starts.

  2. Speak as long as you like.

  3. 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.

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:

DeliveryBehaviour
pasteThe 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.
copyVoisu 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.

Speaking tips