VoiceFlow
Local voice dictation and meeting recorder for Windows + Linux. Hold a hotkey to dictate, or record long-form meetings with system audio. Whisper transcription, bring-your-own-LLM summaries. Open source.
Hold a hotkey. Speak. Release. The transcript pastes itself at your cursor. The project is written primarily in Python, distributed under the MIT License license, first published in 2025. Key topics include: audio-recording, cross-platform, dictation, faster-whisper, hyprland.
What it does
VoiceFlow lives in your system tray. Hold a global hotkey, a small popup pops up with a live amplitude meter, you talk, you release, and the transcript is typed at the cursor. That's it.
The inference runs on your machine through faster-whisper. CUDA when you have it, CPU when you don't. The audio never touches a network socket.
<h2 id="meetings">Meetings <sub><sup>new in v1.6.0</sup></sub></h2>Long-form recording that captures your mic plus system audio (Zoom, Meet, anything that plays through your speakers) into one stereo file, transcribes it locally with Whisper, and runs the summary through an LLM provider you choose.
<p align="center"> <img src="media/meetings-detail.png" alt="Meeting detail with transcript, summary, and audio player" width="100%"> </p>- System audio + mic in one file. Stereo capture via WASAPI loopback (Windows) and PipeWire/PulseAudio (Linux).
- Pause, resume, stop from the dashboard or the tray menu — recording survives across hour-long calls.
- Re-transcribe any saved recording with a different model, device, or language without re-recording.
- Bring your own LLM. OpenAI, Groq, OpenRouter, Ollama, or any OpenAI-compatible endpoint. Keys live in your OS keychain.
- Auto-rename from a default timestamp to a real topic once the transcript lands.
- Export to Markdown, plain text, SRT, or structured JSON.
- Built-in playback via the
voiceflow://URL scheme — jump straight from any transcript line into the audio.
Recording, transcription, search, and storage stay local. The only network call is the optional summary request — skip it, point it at a local Ollama, or send it to a provider you already pay for.
Features
- Fully local. Audio stays in RAM. No telemetry, no analytics, no phone-home.
- 16+ Whisper models. Tiny (75 MB) through Large-v3 (3 GB), plus Turbo, distilled, and
.envariants. The picker shows speed, accuracy, parameter count, and disk size for each. - CUDA when available. Auto-detects your GPU, falls back to CPU.
- Hold or Toggle modes. Configurable hotkeys including modifier-only combos like
Ctrl+Win. - Wayland and X11. Native
evdevinput on Linux, Hyprland window rules,wl-copyandwtype/ydotoolfor paste. - 99+ languages. Whisper handles language detection automatically.
- Searchable history. SQLite log of every transcript, stored at
~/.VoiceFlow/. - Dark mode by default. Light and system themes if you want them.
VoiceFlow vs cloud dictation
| VoiceFlow | Cloud services | |
|---|---|---|
| Cost | $0 | ~$10–15/month |
| Where audio goes | Your RAM | Their servers |
| Works offline | Yes | No |
| Account required | No | Yes |
| License | MIT | Closed |
Install
Grab the latest binary from Releases — currently v1.6.0:
- Windows 10/11:
.exeinstaller (Inno Setup) - Linux:
.AppImageor.tar.gz
64-bit only. First launch walks you through a seven-step setup: microphone, compute device, Whisper model download, hotkey. If you delete the model later, a recovery dialog lets you re-download or pick a different one.
Build from source
bashgit clone https://github.com/infiniV/VoiceFlow.git cd VoiceFlow pnpm run setup # installs Node and Python deps pnpm run dev # Vite frontend + Pyloid backend
Platform installers (run on the matching OS):
bashpnpm run build:installer # Windows (.exe via Inno Setup) pnpm run build:installer:linux # Linux (.AppImage and .tar.gz) pnpm run build:installer:macos # macOS (.dmg, unsupported)
Stack
| Layer | Tech |
|---|---|
| Shell | Pyloid (PySide6 + Qt WebEngine) |
| Inference | faster-whisper (CTranslate2) |
| Frontend | React 18, Vite, Tailwind v4, shadcn/ui |
| Storage | SQLite at ~/.VoiceFlow/VoiceFlow.db |
License
MIT. See LICENSE.
Contributors
Showing top 2 contributors by commit count.
