OpenWhispr 语音转文字:免费本地隐私转录的完整上手方案
【免费下载链接】openwhisprVoice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.项目地址: https://gitcode.com/GitHub_Trending/op/openwhispr
OpenWhispr 语音转文字是一款免费开源的语音听写应用,跨平台可用,能把声音变成文本;它也支持本地 Whisper 转录,音频数据不离开你的设备。
安装与首次启动
按系统选安装包即可:
- macOS(Apple Silicon):.dmg
- macOS(Intel):.dmg
- Windows:.exe
- Linux:.AppImage、.deb、.rpm、.tar.gz 都有
从项目发布页下载对应格式,装完就能用。
进阶一点的做法是从源码构建,前提是装好 Node.js 24+:
git clone https://gitcode.com/GitHub_Trending/op/openwhispr cd openwhispr npm install npm run dev首次启动会进入设置向导,依次申请麦克风权限、配置热键。走完这两步,听写就能用了。
先打开隐私模式
做隐私转录,最稳的做法是先把 OpenWhispr 语音转文字切到本地 Whisper。本地 Whisper 设置一共五步:
- 右键托盘图标,或点应用覆盖层,打开控制面板
- 进入 设置 → 语音转文字处理
- 启用 使用本地Whisper
- 选一个模型,推荐 base
- 点保存
选定的 GGML 模型会在首次转录时自动下载,不用手动搬文件。
模型怎么选,看这张表:
| 模型 | 大小 | 速度 | 质量 | 内存需求 | 最佳用途 |
|---|---|---|---|---|---|
| tiny | 75MB | 最快 | 基础 | ~1GB | 快速笔记 |
| base | 142MB | 快 | 良好 | ~1GB | 推荐 |
| small | 466MB | 中等 | 较好 | ~2GB | 专业使用 |
| medium | 1.5GB | 慢 | 高 | ~5GB | 高精度需求 |
| large | 3GB | 最慢 | 最佳 | ~10GB | 最高质量要求 |
背后的实现不复杂:whisper.cpp 二进制随应用捆绑,找不到时就回退到系统安装;GGML 模型首次使用时下载到~/.cache/openwhispr/whisper-models/;音频由捆绑的 FFmpeg 在本地处理,全程不出机器。
日常场景上手
听写与笔记:按下热键,文本自动落到光标处
在任何应用里按下全局热键开始说话,结束后文字直接粘贴到输入位置,标点和格式自动处理,识别多种语言与方言。默认按键不合适的话,去 设置 → 热键 里逐条改:开始/停止听写、AI 助手、会议转录开始/停止、全局激活应用,各自独立。
识别率想要稳定,记住四点:环境安静、语速适中且发音清晰、模型与设备性能匹配、输入语言选对。
笔记功能也在这一侧:新建、整理、搜索,支持文件夹管理、语义搜索和云端同步。
会议转录:提前连好日历,通话自动识别
先把 Google 日历接上。之后 OpenWhispr 能自动检测 Zoom、Teams、FaceTime 通话,实时转录,并靠语音指纹做说话人区分。习惯上:会前先把应用启动,用云端转录时保证网络稳定,会后拿笔记整理要点。
AI 助手:无需唤醒词,直接下指令
助手有独立热键,按下去说话就是发送指令,不用喊唤醒词。模型侧可选 GPT-5、Claude、Gemini、Groq、Tinfoil 等多种;换成本地模型,请求同样不离开设备。
问题速查
麦克风权限被拒
症状:提示"权限被拒绝"、麦克风弹窗不出现、"未检测到麦克风"。
- macOS:系统设置 → 隐私与安全性 → 麦克风,确认 OpenWhispr 已启用
- Windows:设置 → 隐私 → 麦克风,打开"允许应用访问你的麦克风",并启用 OpenWhispr 一项
- Linux:没有应用级麦克风权限,用
pavucontrol之类的工具检查输入设备是否选对
转录结果为空
症状:历史记录里只有"你"或空白条目。
按顺序排查:查麦克风权限;到声音设置确认输入设备正确;清缓存rm -rf ~/.cache/whisper;换一个热键试试;最后重跑一遍设置向导。
本地转录失败
症状:报错"whisper.cpp 未找到"。
- 源码运行的话,先补当前平台的二进制:
npm run download:whisper-cpp - 捆绑二进制不可用时,用包管理器装:macOS 执行
brew install whisper-cpp;Linux 需从源码构建 - 清模型缓存:
rm -rf ~/.cache/openwhispr/whisper-models - 以上都不行,先用云端转录顶替,本地问题之后再处理
卡住时查 TROUBLESHOOTING.md,里面有分平台的诊断命令和逐项排查步骤。
【免费下载链接】openwhisprVoice-to-text dictation app with local (Nvidia Parakeet/Whisper) and cloud models (BYOK). Privacy-first and available cross-platform.项目地址: https://gitcode.com/GitHub_Trending/op/openwhispr
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
