Skip to content

A powerful LaTeX formula recognition tool powered by pix2tex and pix2text. Features real-time MathJax preview, multi-format export (LaTeX, Markdown, MathML, HTML, OMML, SVG), and one-click copy to Word/Office. Offline-first, privacy-focused portable executable.

License

Notifications You must be signed in to change notification settings

SakuraMathcraft/LaTeXSnipper

Repository files navigation

LaTeXSnipper ✨

🎯 一键截图,即得 LaTeX 公式 | Screenshot → LaTeX Formula in Seconds

latexsnipper

📊 项目统计

Stars Forks Issues License Version Platform Python

GitHub Release Last Commit Activity


LaTeXSnipper 是一款开源跨平台桌面工具,基于深度学习模型(pix2tex 和 pix2text),将图片中的数学公式快速识别并转换为多种格式代码。

通过简单的截图操作,即可得到对应的 LaTeX、MathML、Markdown 等多格式公式,大幅提升数学文档编辑效率


📸 功能演示

latexsnipper5
📐 智能识别
毫秒级识别各类数学公式
latexsnipper7
🔄 多格式转换
支持 6+ 种输出格式
latexsnipper6
👀 实时预览
识别效果即时反馈
依赖选择
🔐 离线运行
隐私保护,无需联网

✨ 核心功能

功能 说明
📸 智能识别 截图识别数学公式,支持公式/文本/混合内容
🔄 多格式转换 支持 LaTeX、Markdown、MathML、HTML、OMML、SVG 等格式
🚀 离线运行 内置模型,无需联网,隐私安全
🎯 实时预览 公式识别即时预览,效果一目了然
快捷便利 一键复制到剪贴板,集成系统快捷键
📦 零依赖 便携式 exe 可执行文件,开箱即用
🔧 高度可定制 支持模型选择、导出格式、快捷键自定义

🚀 快速开始

方法一:下载可执行文件 (推荐) ⭐

Windows 用户最简单的方式,内置 Python

  1. 访问 Releases 页面
  2. 下载最新版 LaTeXSnipper-v1.05.exe
  3. 双击运行即可,首次启动会自动下载必要模型(约 2GB+)
  4. ✅ 完成!开始截图识别公式

⚠️ 重要说明(Windows 用户必读)

请确保已安装 Microsoft Visual C++ Redistributable
否则可能出现缺少 msvcp140.dll 等报错。一键下载安装即可。

方法二:从源码安装(可能报错,需要调试)

# 克隆仓库
git clone https://github.com/SakuraMathcraft/LaTeXSnipper.git
cd LaTeXSnipper

# 创建并激活虚拟环境
python -m venv .venv
.\.venv\Scripts\activate  # Windows
# macOS/Linux: source .venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 运行程序
python src/main.py

⚠️ 首次运行需保持网络连接,pix2tex 模型权重会自动下载。


📖 使用说明

基础流程

  1. 打开应用 - 启动 LaTeXSnipper
  2. 截图公式 - 点击"截图公式"按钮或按下配置的快捷键
  3. 框选区域 - 用鼠标拖拽框选屏幕上的数学公式
  4. 自动识别 - 程序自动识别公式内容
  5. 实时预览 - 在预览面板中查看多格式转换结果
  6. 复制使用 - 点击复制相应格式代码到剪贴板
  7. 粘贴文档 - 粘贴到你的 LaTeX、Word、Markdown 等文档中

快捷键

快捷键 功能
Ctrl+F 启动截图识别(可自定义)
ESC 取消当前截图操作

导出格式说明

  • LaTeX - 标准数学模式,可直接用于 LaTeX 文档
  • Markdown - 支持行内 $...$ 和 block $$...$$ 格式
  • MathML - W3C 标准数学标记语言
  • HTML - HTML5 数学公式表示
  • OMML - Office Open XML 格式(Word 兼容)
  • SVG - 向量图形格式,可嵌入网页

🏗️ 项目结构

LaTeXSnipper/
├── src/                          # 源代码
│   ├── main.py                  # 主程序入口
│   ├── deps_bootstrap.py        # 依赖管理和引导安装
│   ├── updater.py               # 更新检查模块
│   ├── config.json              # 配置文件
│   ├── backend/                 # 后端模块
│   │   ├── model.py             # 模型管理
│   │   ├── capture_overlay.py   # 截图覆盖层
│   │   └── qhotkey/             # 全局快捷键
│   ├── core/                    # 核心功能
│   │   ├── utils.py             # 工具函数
│   │   ├── constants.py         # 常量定义
│   │   └── config.py            # 配置管理
│   ├── ui/                      # UI 组件
│   │   ├── dialogs.py           # 对话框
│   │   └── widgets.py           # 自定义控件
│   └── assets/                  # 资源文件
│       └── MathJax-3.2.2/       # MathJax 库
├── requirements.txt              # 项目依赖
├── LaTeXSnipper.spec            # PyInstaller 打包配置
├── LICENSE                       # MIT 许可证
└── README.md                     # 本文件

📈 项目活跃度

⭐ Star 历史

Star History Chart

🤝 贡献指南

欢迎通过以下方式贡献代码:

  1. Fork 本仓库
  2. 创建特性分支 (git checkout -b feature/amazing-feature)
  3. 提交改动 (git commit -m 'Add amazing feature')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 开启 Pull Request

请确保你的代码:

  • 可以优化我们的史山代码
  • 包含必要的注释和文档
  • 通过所有测试

� 支持项目

如果这个项目对你有帮助,请考虑:

  • 点个 Star - 这是最简单的支持方式
  • 🐛 报告 Bug - 帮助我们改进项目
  • 💬 分享反馈 - 你的建议很宝贵
  • 🔗 分享给朋友 - 让更多人知道这个项目
  • 💰 赞助开发者 - 赞助链接(暂未开放)

📄 许可证

本项目遵循 MIT 许可证,详见 LICENSE 文件。

你可以自由地使用、修改和分发此项目,只需在许可证中保留原始署名。


� 贡献者

me
SakuraMathcraft
💻 开发者 & 维护者

欢迎贡献! 如有帮助,请提交 PR 或 Issue。

🙏 致谢

感谢以下开源项目的支持:


Made with ❤️ by SakuraMathcraft

📦 快速链接

📥 🐛 💬 📖
下载最新版本 报告 Bug 讨论功能 查看 Wiki

⚡ 提示: 有任何问题?查看 FAQ 或提交 Issue

About

A powerful LaTeX formula recognition tool powered by pix2tex and pix2text. Features real-time MathJax preview, multi-format export (LaTeX, Markdown, MathML, HTML, OMML, SVG), and one-click copy to Word/Office. Offline-first, privacy-focused portable executable.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors