Voice input for macOS, Windows, and iOS.
Speak to write on all three platforms. The desktop editions add system-wide dictation workflows; macOS also includes the full local context workbench.
Website · Download · English · 简体中文 · 繁體中文 · 日本語 · 한국어
VoxFlow stays in the app you are already using. It is not a voice assistant: it does not take over your window, move you into another input box, press Enter, or submit messages for you.
It is a voice keyboard first, with a local workbench around the things you capture while working: dictation, screenshots, screen recordings, clipboard items, notes, and local coding-agent instructions.
| Workflow | Trigger | What Happens | Safety Boundary |
|---|---|---|---|
| Speak to type | Hold the dictation shortcut, speak, release | Text is inserted at the current cursor | No focus stealing, no auto-submit |
| Open the launcher | ⌥Space |
Search recent assets, actions, quicklinks, and Ask AI | Keyboard-first, Raycast-style |
| Recover local assets | Launcher or Workbench | Search voice, screenshot, recording, clipboard, and note history | Stored locally by default |
| OCR an image | Copy an image, press ⌘⇧V |
OCR text is pasted into the current field | Image-only workflow |
| Capture the screen | Press ⌘⇧A, select a region |
Review OCR, translation, summary, and the image record | Requires Screen Recording permission |
| Work with selected text | ⌘⇧F/J/K/L/P |
Translate, summarize, send to Task Assistant, or Ask AI | Uses explicit shortcuts |
| Compose for AI tools | Speak intent with window context | A prompt is copied for ChatGPT, Claude, Codex, Cursor, or similar tools | Copy only |
| Command local agents | Speak an agent name and task | Dispatch to registered Codex, Claude, CodeBuddy, or terminal-agent sessions | Registered sessions only |
- People who write, code, debug, and explain things faster by speaking than typing.
- Users who switch between ChatGPT, Claude, Codex, Cursor, terminal agents, notes, screenshots, and browser research.
- Developers who need accurate mixed Chinese-English technical dictation.
- Anyone who wants screenshots, recordings, clipboard items, and dictated text to become reusable local context.
- Global dictation: Hold to speak and release to insert text in any editable field.
- Local asset workbench: Dictation, screenshots, screen recordings, clipboard items, and notes become searchable assets.
- Multiple ASR providers: Apple Speech works out of the box; local and cloud providers are available when configured.
- Personal corrections: Local deterministic rules and optional conservative LLM correction help stabilize names, terms, and technical words.
- Screenshot and clipboard OCR: Extract text from screenshots, copied images, web pages, error dialogs, and design mockups.
- Ask AI and Quicklinks: The launcher can ask your configured LLM provider or search Google, GitHub, StackOverflow, YouTube, Bilibili, Taobao, JD, and more.
- AI Coding Assistant workflows: Compose prompts or dispatch spoken instructions to local coding-agent sessions.
- Local-first privacy: History and assets stay on your Mac by default; cloud ASR and LLM calls are opt-in.
Download the latest release from GitHub Releases:
| Platform | Package | Installation |
|---|---|---|
| macOS | VoxFlow-1.15.0-macOS.dmg |
Open the DMG and drag VoxFlow to Applications. |
| Windows x64 | VoxFlow-1.15.0-windows-x64-setup.exe or VoxFlow-1.15.0-windows-x64-portable.zip |
Run the per-user installer, or extract the portable package. |
| iOS 17+ | Mashangxie-1.15.0-iOS.ipa |
Install the Ad Hoc IPA on a device whose UDID is registered in the bundled profiles. |
- macOS 15+, Windows x64, or iOS 17+
- A microphone
- iOS IPA installation requires a device registered for this Ad Hoc release
| Permission | Why VoxFlow Needs It |
|---|---|
| Accessibility | Listen for global shortcuts and insert text into the current app |
| Microphone | Record your voice |
| Speech Recognition | Use Apple Speech when selected |
| Screen Recording | Read current-window context, screenshot OCR, and screen recording content |
If a shortcut does not respond after granting permissions, quit and reopen VoxFlow.
| Shortcut | Action |
|---|---|
⌥Space |
Open the VoxFlow launcher |
| Dictation shortcut | Hold to speak, release to insert; configurable in Settings |
⌘⇧V |
OCR clipboard image and paste recognized text |
⌘⇧A |
Capture a screen region and open the OCR result panel |
⌘⇧F |
Open selection actions |
⌘⇧J |
Translate selected text |
⌘⇧K |
Summarize selected text |
⌘⇧L |
Send selected text to Task Assistant |
⌘⇧P |
Send selected text to Ask AI |
- Place your cursor in any text field.
- Hold the dictation shortcut.
- Speak while the overlay shows live recognition.
- Release the shortcut. VoxFlow inserts the final text at the cursor.
Open the Workbench to review local history, screenshots, recordings, notes, personal corrections, models, provider settings, and AI Coding Assistant sessions.
Use ⌘⇧V for copied images and ⌘⇧A for a selected screen region. OCR text can be copied, spoken, translated, summarized, or reused later from the Workbench.
Task Assistant turns visible window context plus spoken intent into a prompt. AI Coding Assistant dispatches spoken instructions to registered local coding-agent sessions.
See Agent workflows for setup and safety boundaries.
VoxFlow supports Apple Speech out of the box, local providers such as Qwen3-ASR, Whisper, FunASR, SenseVoice, Paraformer, NVIDIA Nemotron, Parakeet, and Omnilingual, plus optional cloud providers such as Groq, Tencent Cloud, Alibaba Cloud, and future provider slots.
See Speech models for the full provider matrix.
- Dictation history, screenshots, recordings, clipboard assets, notes, personal corrections, and non-secret settings are stored locally by default.
- LLM API keys and cloud ASR credentials are stored in the local credentials file.
- Local ASR models keep audio on-device.
- Cloud ASR sends recorded audio to the selected provider.
- LLM correction and Ask AI send text only to the provider you configure.
- Diagnostics are local by default; crash or trace upload behavior is controlled by settings.
See Privacy and data and Privacy Policy for details.
| Topic | Link |
|---|---|
| Documentation index | docs/README.md |
| Speech model matrix | docs/speech-models.md |
| Agent workflows | docs/agent-workflows.md |
| Privacy and data storage | docs/privacy-and-data.md |
| Build from source | docs/build-from-source.md |
| Third-party licenses | docs/third-party-licenses.md |
git clone https://github.com/xingbofeng/VoxFlow.git
cd VoxFlow
make run-devSee Build from source for commands, source layout, and development notes.
Follow the author on X: @Counterxing
Scan the QR codes below to add the author on WeChat or join the VoxFlow user group.
Add WeChat
|
Join the user group
|