opennookorg/betterwispr

选用指南

AI 根据 README 整理 · 2026/10/21 07:16:06

使用方式

通过图形界面使用，按住快捷键说话即可听写，也可转写音频文件或链接。

查看 README 依据

<div align="center">  # 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.

- **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. - **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.

部署要求

需要 macOS 14 或更高版本，推荐 Apple Silicon。

查看 README 依据

## Requirements - macOS 14 or later - Apple Silicon recommended ## Getting started 1. Download the DMG from [Releases](https://github.com/opennookorg/betterwispr/releases/latest) 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.

已知限制

Apple 设备端模型可能不支持某些语言或系统语音资源；首次转录较慢；录音超过十分钟会自动停止。

查看 README 依据

- 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

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 |