Voiceflow
Download
VoiceFlow documentationInstallation & permissionsQuickstartDictation modeAsk modeShortcutsCustom dictionaryHistory & statsSystem architectureAudio capture pipelineTranscription strategyAI processing & text injectionGlobal key listenerData model & storageIPC channelsConfigurationBuild & release
Get started

Installation & permissions

Download VoiceFlow, grant the macOS permissions it needs to listen and paste, and add your Groq API key.

OS

macOS 13 Ventura or newer

Chip

Apple silicon (arm64)

You provide

A Groq API key

Requirements

  • A Mac running macOS 13+ on Apple silicon.
  • A Groq API key — create one for free at console.groq.com. It is stored locally and used for both transcription and polish.
  • A working microphone. VoiceFlow captures mono audio and downsamples it to 16 kHz before sending.

Download & open

  1. 01Download the DMGGrab the latest VoiceFlow.dmg from the releases page and drag the app into Applications.
  2. 02Open it the first timeBecause the build is not notarized, macOS may warn on first open. Right-click the app and choose Open, or allow it under System Settings → Privacy & Security.
  3. 03Find it in the menu barVoiceFlow runs as a tray app. The dashboard window opens on launch; you can reopen it any time from the menu-bar icon.

Prefer to build from source?

See Build & release for the full toolchain — Electron Forge, Vite, and the Rust key listener.

macOS permissions

VoiceFlow is macOS-first and relies on three system permissions. On first launch it checks Accessibility and, if it is missing, offers to open System Settings for you.

Microphone

Required to record audio. macOS prompts the first time you start a recording.

Accessibility

Powers the global key listener and the simulated ⌘V paste. Without it, results are only copied, not pasted.

Automation / Apple Events

Lets VoiceFlow re-activate the target app and read selected text through osascript / JXA.

Accessibility is the important one

Grant it under System Settings → Privacy & Security → Accessibility. In development the permission attaches to the terminal or editor that launched the app; in the packaged build it attaches to VoiceFlow itself.

Add your Groq API key

  1. 01Open SettingsIn the VoiceFlow dashboard window, go to the Settings screen.
  2. 02Paste your keyPaste the key from console.groq.com. It is written to the local config store and never leaves your machine except in requests to Groq.
  3. 03Pick a microphone (optional)Leave it on the system default, or choose a specific input device if you use an external mic.