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
voisucommand, 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.