macOS 极速本地 OCR 工具
-000000?style=flat-square&logo=apple){kind=icon}
SnapText 是一款专为 macOS 设计的高性能本地 OCR 工具。它常驻于菜单栏，基于 RapidOCR (ONNX Runtime) 引擎，能够利用 Apple Silicon 的强劲算力，瞬间捕捉并识别屏幕上的文字。
核心理念：隐私第一，速度至上。 所有识别过程完全在本地完成，无需联网，无需上传图片。
| 特性 | 说明 |
|---|---|
| 🔒 隐私至上 | 无需互联网连接，无需 API 密钥。数据绝不出本地。 |
| ⚡️ 极致性能 | 基于 RapidOCR + ONNX Runtime，毫秒级响应速度。 |
| 🖥 原生体验 | 适配 macOS 菜单栏，支持深色模式，UI 简洁优雅。 |
| ⌨️ 全局热键 | 随时随地，按下快捷键即可截图识别。 |
| 🔌 Bob 集成 | 完美支持作为 Bob 的离线 OCR 引擎。 |
Important
仅支持搭载 Apple Silicon (M1/M2/M3) 芯片的 Mac 设备。
- 操作系统：macOS 11.0 (Big Sur) 或更高版本
- 磁盘空间：约 300MB (包含 OCR 模型)
- 访问 Releases 页面 下载最新版本的
.dmg安装包。 - 打开 DMG 文件，将 SnapText.app 图标拖入右侧的 Applications 文件夹。
- 在启动台 (Launchpad) 中找到 SnapText 并启动。
Warning
提示“SnapText 已损坏，无法打开” ？
这是 macOS Gatekeeper 的安全机制导致的（因为应用使用 Ad-hoc 签名）。请在终端 (Terminal) 中运行以下命令一键修复：
sudo xattr -cr /Applications/SnapText.app首次运行权限： 请务必授予 屏幕录制 和 辅助功能 权限，否则截图和全局快捷键将无法工作。
| 功能 | 默认快捷键 | 说明 |
|---|---|---|
| 截图识别 | Cmd + Opt + S |
鼠标框选区域，松开即识别 |
| 退出应用 | (菜单栏操作) | 点击菜单栏图标 > 退出 |
您可以在“偏好设置”中自定义快捷键。
- 启动：打开应用，菜单栏会出现 SnapText 图标。
- 截图：按下快捷键（默认
Command+Shift+O），光标变为截图模式。 - 识别：框选需要识别的文字区域。
- 结果：
- 识别的文字自动 复制到剪贴板。
- 弹出系统通知提示识别成功。
SnapText 可以作为 Bob 翻译软件的 免费、离线 OCR 服务端。
- 确保 SnapText 主程序正在后台运行。
- 下载最新的 SnapText-Bob-Plugin 插件。
- 双击安装到 Bob。
- 在 Bob 设置中：【偏好设置】>【翻译】>【服务】>【添加插件】，选择安装的
.bobplugin文件。
如果您是开发者并希望从源码构建：
# 1. 克隆仓库
git clone https://github.com/thirteenkai/snaptext.git
cd snaptext
# 2. 安装依赖
pip install -r LocalOCR/requirements.txt
# 3. 运行
python3 LocalOCR/main.py本项目使用了以下优秀的开源项目：
MIT License 开源。