Skip to content

Latest commit

 

History

1,031 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LaTeXSnipper ✨

Turn screenshots, images, PDFs, and handwriting into editable formulas and text.

GitHub Release GitHub Stars GitHub Downloads Platform License

Download · User Manual (Chinese) · FAQ · Demos

English · 简体中文

LaTeXSnipper v3.0.0: recognition history, formula editor, and live preview

What You Can Do

Feature What it offers
📸 Recognize Capture a region, open an image, select PDF pages, or write by hand; recognize formulas, text, and mixed content
⌨️ Edit and compute Edit with MathLive and live preview; simplify, evaluate, and solve in the math workspace
🔄 Export Copy formulas or export documents in 20 formats, including LaTeX, MathML, Word, PDF, and Typst
🧩 Integrate Work in Word/PowerPoint or connect scripts and other tools through the Automation API
🧠 Choose your model Run MathCraft OCR locally after downloading dependencies and weights, or configure a local/online external model
🎨 Make it yours English/Chinese interface, light/dark themes, configurable shortcuts, history, and favorites

MathCraft OCR: benchmark results · reproduce the benchmarks


Download and Get Started

  1. Install the desktop app. Choose the package for your system from Releases.
  2. Prepare recognition. Install the recognition environment required by the model you want to use.
  3. Recognize and edit. Use Capture Recognize, Image, PDF, or Handwriting, then review, copy, or export the result.

Important

On first launch, use Dependency Management to install the required layers and a CPU or GPU backend for MathCraft OCR. Initial model setup requires downloading weights. If using only an external model, configure and test its connection in Settings instead.

Platform Download Before using recognition
Windows LaTeXSnipperSetup-<version>.exe Python runtime included; no separate system Python installation needed
Linux (Debian/Ubuntu) .deb for your architecture Python >=3.10,<3.14 with venv/pip; Wayland may restrict screenshots and global shortcuts
macOS .dmg or .app.zip for your architecture Python >=3.10,<3.14 with venv/pip; grant Screen Recording permission for screenshots

Note

Linux/macOS use system Python to create the managed dependency environment; Windows uses its bundled Python 3.11 template. The .deb declares python3 and python3-venv dependencies. On macOS, install a supported Python version if one is not available.

Tip

For permissions, model downloads, environment paths, and troubleshooting, see the FAQ, user data locations, and full user manual (Chinese).


Demos

Screenshot Recognition

Screenshot recognition demo

Image Recognition

Image recognition demo

PDF Recognition

PDF recognition demo


Microsoft Office Plugin

Note

The Office plugin is designed for Windows desktop Microsoft Word and PowerPoint, where you can insert and edit formulas directly.

  • Word OLE/OMML and PowerPoint OLE/PNG insertion, with editable LaTeX source.
  • Formula editing, updates, and Word automatic numbering and references.
  • Local formula rendering and screenshot OCR through the desktop Automation API.

Download OfficePluginSetup-<version>.exe separately from Releases. Supports 32-bit and 64-bit Office 2019/2021/2024, LTSC 2021/2024, and Microsoft 365 Apps on Windows.

Installation requirements and features · Formula workflows


Automation API

Use MathCraft or your configured external model from scripts, batch jobs, editor integrations, or authorized remote devices.

  • Desktop shortcuts: connect Snipaste, AutoHotkey, AutoKey, Hammerspoon, or ShareX to an image-recognition workflow.
  • Batch and editor workflows: submit images with Python/curl and insert results into your tools.
  • Mobile access: connect Shortcuts or Tasker to your running desktop app through a secure tunnel.

Caution

The API is disabled by default. Local clients use the address and token in automation-api.json. Remote access requires explicit opt-in, a separate key, and HTTPS or an encrypted tunnel; do not expose it over plain public HTTP. Remote external-model access is separately controlled and may incur provider charges.

API reference and connection setup · Ready-to-adapt client examples


Export

Built-in exports cover LaTeX, Markdown math, MathML, HTML, Word OMML, and SVG code.

Note

Install the optional Pandoc layer in Dependency Management for document exports such as Word, PowerPoint, EPUB, PDF, and Typst. PDF export also requires a LaTeX PDF engine.

See the user manual for the full format list and requirements.


Supporters

Thanks to everyone who helps with development, testing, documentation, and community support.

Supporter Contribution
strangelion Contributor
Galileo927 Contributor
ljygo Sponsor
Yokie-D Sponsor

Support the Project

LaTeXSnipper is a free, open-source, ad-free personal project with no in-app purchases. If it helps your work, consider starring the repository, sharing it, reporting an issue, or sponsoring maintenance.

Alipay WeChat Pay Community chat (Chinese)
Alipay donation QR code WeChat Pay donation QR code LaTeXSnipper community chat QR code

License

GNU General Public License v3.

About

Formula Recognition & Office Editing Math Workspace | Handwriting & PDF to LaTeX/Markdown, And Secure API Integrations.

Topics

Resources

Stars

967 stars

Watchers

4 watching

Forks

Releases

Packages

Contributors

Languages