opennookorg/betterwispr

Public

Free, open-source, local-first dictation app for macOS. Hold a shortcut, speak, and text is typed into any app. On-device speech-to-text with Whisper, Parakeet and Apple speech. Private, offline, open-source Wispr Flow alternative.

  • Stars469+50 tuần này
  • Forks38
  • Watchers1
  • Issues15
  • Ngày tạo08/10/2026
  • Cập nhật gần nhất25/10/2026
  • Ngôn ngữSwift
  • Giấy phépApache-2.0
README.md10.5 KBRaw

BetterWispr: hold to talk, release to type

BetterWispr

Free, open-source voice dictation for macOS. Hold ⌥ Space, speak, release, and the text lands in whatever app you were typing in.

BetterWispr is a private, offline speech-to-text app and an open-source alternative to Wispr Flow. It transcribes on your Mac with Whisper, NVIDIA Parakeet or Apple's on-device speech recognition, so your voice never leaves your computer unless you explicitly select an API connection or Codex subscription transcription.

Download the latest release · Website · Changelog

Buy me a coffee

Features

  • Dictate anywhere: hold-to-talk or press-to-toggle, with a shortcut you choose.
  • On-device models: Apple speech, Parakeet v3 (25 European languages), Parakeet v2 (English) and Whisper large-v3 turbo.
  • Vocabulary: spelling hints and phrase replacements for names and jargon.
  • Learns your corrections: fix a misheard word once (in History, or right after it's pasted) and it's spelled right next time.
  • Voice commands: say "comma", "new line", "scratch that" or "sorry, remove that", and "at the rate KV" for "@KV".
  • Meetings: live transcript of you and the other side, plus on-device titles, summaries and action items with Apple Intelligence or a local Ollama model.
  • Transcribe files and links: drop in an audio or video file or paste a video link and get a timestamped transcript with the model you choose, to copy or export as text or Markdown. Links use yt-dlp, which BetterWispr installs only when you click Install.
  • Connected apps: let Claude, Cursor and other apps that support MCP list, search and read your meeting notes and transcripts. Off by default and read-only.
  • Send to Claude: optionally press Return after pasting, only into Claude Desktop or Claude Code in the VS Code panel, Terminal or iTerm2. Off by default.
  • History: raw and corrected transcripts, stored locally (can be turned off).
  • Bring your own model: optional Sarvam AI, Smallest AI or any OpenAI-compatible endpoint.

Requirements

  • macOS 14 or later
  • Apple Silicon recommended

Getting started

  1. Download the DMG from Releases and drag BetterWispr to Applications.
  2. Open it and follow the welcome guide.
  3. Pick a model in Models. Apple on-device needs no download; Parakeet and Whisper download once, then work offline.
  4. Grant Microphone access, and Accessibility access so BetterWispr can paste for you.
  5. Click into a text field in any app, hold ⌥ Space, speak, and release.

If paste can't safely reach the previous app, the text is copied to your clipboard instead, so you never lose a dictation. Recordings stop automatically after ten minutes, with a countdown in the last 30 seconds.

Bring your own model

Models → Bring your own model → Add connection. Choose a provider, enter the model ID and API key, save, then click Use.

Provider Default model Notes
Sarvam AI saaras:v4 Long recordings are sent in 25-second chunks
Smallest AI pulse Set an explicit spoken language in Settings
OpenAI-compatible any Full URL, e.g. http://localhost:8000/v1/audio/transcriptions. HTTPS required except on localhost

When a connection is in use, your audio goes to that endpoint and its pricing and retention policies apply. Keys are stored in the macOS Keychain. Switch back to a built-in model to return to fully local transcription. BetterWispr never falls back to a cloud provider on its own.

Privacy

For optional subscription transcription, see Codex subscription setup. BetterWispr uses your local Codex sign-in directly with an unofficial ChatGPT endpoint. Audio goes to ChatGPT only when you select this model and start transcription.

  • Settings, vocabulary and history live in ~/Library/Application Support/BetterWispr/workspace.json (not encrypted).
  • Models live in the Models folder next to it.
  • With Remember named voices on, voice profiles of the speakers you name live in Voices.json next to it (not encrypted). Forget Voices in Models deletes them, and deleting a meeting deletes the profiles named in it.
  • Audio is written to temporary files and deleted after each recording.
  • Built-in models only touch the network when you explicitly download one.
  • Send to Claude is off by default. When it is on, BetterWispr reads the list of running processes on this Mac to find Claude Code, and asks Terminal and iTerm2 which tab is in front once you allow it. Nothing is stored or sent.
  • Connected apps is off by default. When you turn it on, apps you connect read your meetings through BetterWispr --mcp on this Mac and send what they read to their own AI provider.

Troubleshooting

  • Paste stopped working after an update or rebuild: remove and re-add BetterWispr in System Settings → Privacy & Security → Accessibility.
  • Apple on-device model unavailable: your language or OS speech assets may not support it. Install Parakeet or Whisper instead.
  • First transcription is slow: large models take time to load the first time.

Contributing

Build instructions, project layout and guidelines are in CONTRIBUTING.md.

Star history

Star history of opennookorg/betterwispr

License

Apache-2.0. Third-party code and model weights keep their own terms;

Nội dung README thuộc về opennookorg và cộng đồng đóng góp, giấy phép Apache-2.0. Nguồn: github.com/opennookorg/betterwispr