Voisu docs

Voisu is voice dictation for Linux, Windows and macOS. You press your key, speak, and the Transcript lands in the window you were typing in.

New here? Start with Getting started: install, add your keys and make your first Recording. It takes a few minutes.

Getting started
Install on Linux, Windows or Mac, add your keys and make your first Recording.
Set up on Mac
Install on an Apple Silicon Mac, let macOS open it once with Open Anyway, and allow its three permissions.
Install with an agent
One prompt for Claude Code, Codex or another terminal agent. Your keys stay out of the chat.
Dictating
Trigger Keys, hands-free, cancelling, the capsule's states and your last Transcript.
Providers & API keys
What Deepgram and Groq do, where to get keys, and where Voisu stores them.
Updating & uninstalling
Keep Voisu current, or remove it cleanly.
Settings & commands
The Windows settings window and tray, every Linux voisu command, and where files live.
Privacy
What leaves your machine, what stays on it, and how to clear it.
Troubleshooting
Trigger Key, portals, keys, microphone, a paste that didn't land, SmartScreen.

A few words we use

Recording
The audio captured between starting and stopping dictation.
Transcript
The final text Voisu produces from a Recording.
Trigger Key
On Linux, the shortcut you approved for Voisu. Its first press starts a Recording and the next press stops it. On Windows the gesture is Ctrl Win, on a Mac Control Option.
Delivery
Putting the Transcript into the app you're using. If that can't happen, the Transcript stays on your clipboard.
Overlay
The small capsule that shows Voisu is listening, working, or has hit a problem.

Hold or press. On Windows and Mac you hold the Trigger Key (Ctrl Win, or Control Option) while you speak and release to finish. On Linux you press the Trigger Key once to start and again to stop.