SnapText

macOS 极速本地 OCR 工具

---

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 模型)

🚀 安装指南

1. 访问 Releases 页面 下载最新版本的 .dmg 安装包。
2. 打开 DMG 文件，将 SnapText.app 图标拖入右侧的 Applications 文件夹。
3. 在启动台 (Launchpad) 中找到 SnapText 并启动。

常见问题排查

Warning

提示“SnapText 已损坏，无法打开” ？

这是 macOS Gatekeeper 的安全机制导致的（因为应用使用 Ad-hoc 签名）。请在终端 (Terminal) 中运行以下命令一键修复：

sudo xattr -cr /Applications/SnapText.app

首次运行权限： 请务必授予 屏幕录制 和 辅助功能 权限，否则截图和全局快捷键将无法工作。

📖 使用说明

常用快捷键

功能	默认快捷键	说明
截图识别	Cmd + Opt + S	鼠标框选区域，松开即识别
退出应用	(菜单栏操作)	点击菜单栏图标 > 退出

您可以在“偏好设置”中自定义快捷键。

使用流程

1. 启动：打开应用，菜单栏会出现 SnapText 图标。
2. 截图：按下快捷键（默认 Command+Shift+O），光标变为截图模式。
3. 识别：框选需要识别的文字区域。
4. 结果：
   • 识别的文字自动 复制到剪贴板。
   • 弹出系统通知提示识别成功。

🧩 Bob 插件集成

SnapText 可以作为 Bob 翻译软件的 免费、离线 OCR 服务端。

1. 确保 SnapText 主程序正在后台运行。
2. 下载最新的 SnapText-Bob-Plugin 插件。
3. 双击安装到 Bob。
4. 在 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

� 致谢

本项目使用了以下优秀的开源项目：

• RapidOCR: 提供了强大的离线 OCR 推理引擎。
• Bob: 提供了优秀的翻译软件和插件生态。
• rumps: 提供了简洁的 macOS 菜单栏应用框架。

📄 License

MIT License 开源。