WhimprFlow

A local-first voice dictation app for macOS. Tap a key, speak, and clean text lands wherever your cursor is. Speech is transcribed on-device with Whisper and cleaned up by a local LLM (filler removal, self-corrections, spoken punctuation, lists), with optional cloud cleanup.

This is a heavily extended fork of Blueturboguy07/WhimprFlow (MIT). Not affiliated with, endorsed by, or connected to Wispr Flow or any other product.

The whole app ships in English and German and follows your macOS language.

What it does

• On-device ASR: Whisper (whisper.cpp, Metal), multilingual with auto language detection. German and English work great, including mixed use.
• Local LLM cleanup: Qwen (llama.cpp) removes fillers ("um", "ähm"), resolves spoken self-corrections ("Dienstag, nee warte, Donnerstag"), converts spoken punctuation ("Punkt", "question mark"), formats lists. Persistent KV cache: the prompt prefix is prefilled once, so cleanup is fast.
• Optional cloud cleanup: OpenAI, Anthropic, or any OpenAI-compatible API (Mistral, OpenRouter, Groq) via a custom base URL. Keys live in the macOS keychain, never in files. Only the transcript text is sent, never audio.
• The pill: a small floating bar above the Dock. Tap your dictation key (Fn) to toggle recording, hold it for push-to-talk, Esc cancels. Hover the pill for a mic button. Drag it anywhere; it snaps to screen edges and corners, and turns vertical on the side edges.
• Context awareness: reads the text around your cursor (Accessibility API) so cleanup understands names and what you are replying to. Follow-up dictations within 90 seconds carry the previous one as context. Everything stays on your Mac; toggle in Settings.
• Snippets: say a trigger phrase ("my email address"), get the stored replacement.
• Style: formal / casual / very casual output per app category (personal chat, work chat, email, other), detected from the app you dictate into.
• Transforms: select text anywhere, press Alt+1/2/3, and the selection is rewritten in place (polish, prompt-engineer, organize). Prompts and shortcuts are editable.
• Scratchpad: a quiet autosaving page in the hub for long-form dictation.
• Quality-of-life: personal dictionary with auto-learn, usage stats and streaks, silence-hallucination filter, smart spacing when dictating mid-text, pauses Spotify/Music while recording, menu-bar-only app with autostart.

Privacy

ASR and default cleanup run on-device. Cloud cleanup is opt-in and sends only the transcript text to the provider you choose. Context awareness reads the focused text field locally and never leaves your Mac. API keys are stored in the macOS keychain.

License

MIT, see LICENSE. Based on Blueturboguy07/WhimprFlow.