LaTeXSnipper ✨

A desktop math workspace for capture -> recognize -> handwrite -> edit -> compute

Star History

---

Overview

LaTeXSnipper is no longer just a "screenshot formula -> LaTeX" utility. It is a desktop workspace built for end-to-end math content workflows:

• Capture and recognize mathematical content from screenshots
• Continue editing and computing in the integrated math workbench
• Handwrite expressions in a dedicated canvas and convert to LaTeX
• Send results back to the main editor or copy to clipboard

---

Feature Walkthrough

Math Workbench

The v2.0 Math Workbench supports a complete workflow:

1. Capture and recognize formulas from the main window
2. Load results into the workbench in one click
3. Edit expressions in the MathLive area
4. Use the virtual math keyboard for fractions, superscripts, integrals, series, and more
5. Run Compute / Simplify / Numeric / Expand / Factor / Solve
6. Write results back to the editor or copy as LaTeX / MathJSON

Auto Typesetting Document Window

The v2.3.2 Auto Typesetting Document Window supports source-level editing with synchronized preview:

1. Open "Auto Typesetting" from the handwriting window
2. Edit full source in the left TeX Document pane
3. Insert complex expressions with the built-in formula editor
4. Compile and preview PDF directly
5. Navigate bi-directionally between source and PDF via SyncTeX
6. Export .tex or PDF when needed

Handwriting Recognition

The v2.1 handwriting window supports the following flow:

1. Open "Handwriting Recognition" from the main window
2. Write formulas directly on an isolated canvas
3. Trigger MathCraft OCR automatically after pen-up
4. See live LaTeX output and rendered preview on the right
5. Copy LaTeX directly or insert it back into the main editor

---

Core Features

Feature	Description
📸 Formula recognition	MathCraft OCR for formulas, text, and mixed content
✍️ Handwriting recognition	Dedicated handwriting window with auto-recognition and live preview
🧮 Math workbench	Separate workspace for editing, computation, and write-back
⌨️ Formula editing	Integrated MathLive math-field with virtual math keyboard
🔄 Multi-format export	LaTeX, Markdown, MathML, HTML, OMML, SVG
📐 Core computation	Compute, simplify, numeric evaluate, expand, factor, solve
🧠 Advanced fallback	Local SymPy/mpmath engine for harder expressions
🌙 Theme support	Light/Dark adaptation across windows and tools
🔐 Offline-first	Recognition and advanced solving can run locally for privacy

---

Computation Coverage

The workbench currently covers common scenarios such as:

• Polynomial expansion
• Factorization
• Equation solving
• Irrational/complex root fallback solving
• Definite and improper integrals
• Infinite series
• Infinite products
• Limits
• Derivatives
• Numeric approximation and constant recognition

For heavy expressions, the engine uses automatic fallback:

1. Try frontend Compute Engine first
2. Switch to local advanced engine on timeout/failure/unreliable results
3. Use SymPy/mpmath for robust fallback
4. Recover closed forms for selected known constants from numeric output

---

Quick Start

Option 1: Download the executable

1. Visit the Releases page
2. Download the latest LaTeXSnipper Final Stable.exe
3. Run the installer
4. Complete environment setup via the dependency wizard on first launch
5. Start capturing, handwriting, or using the math workbench

Option 2: Run from source

git clone https://github.com/SakuraMathcraft/LaTeXSnipper.git
cd LaTeXSnipper

python -m venv .venv
.\.venv\Scripts\activate

pip install -r requirements.txt
python src/main.py

---

Project Structure

LaTeXSnipper/
|-- mathcraft_ocr/                 # Standalone MathCraft OCR runtime and CLI
|-- src/
|   |-- main.py                    # Main desktop application entry
|   |-- deps_bootstrap.py          # Dependency wizard and runtime verification
|   |-- distribution.py            # GitHub / Microsoft Store channel policy
|   |-- backend/                   # OCR wrapper, CUDA diagnostics, capture, platform services
|   |-- core/                      # Document composition, export contracts, restart contracts
|   |-- editor/                    # Math workbench and formula editing UI
|   |-- handwriting/               # Handwriting canvas, PDF preview, document tools
|   |-- assets/                    # Icons and bundled web/math resources
|   `-- deps/                      # Bundled/local Python dependency environment
|-- Inno/                          # GitHub Release installer scripts
|-- packaging/msix/                # Microsoft Store MSIX manifest and notes
|-- scripts/                       # Build, release, and regression utilities
|-- docs/                          # Design and architecture notes
|-- LaTeXSnipper.spec              # PyInstaller GitHub build
|-- LaTeXSnipper.offline.spec      # PyInstaller offline-model build
|-- pyproject.toml
|-- requirements.txt
|-- requirements-build.txt
|-- version_info.txt
`-- README.md

---

Contributing

Contributions are welcome:

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Push your branch
5. Open a Pull Request

Recommended focus areas:

• Handwriting UX
• Math workbench UX
• Advanced solver stability
• Packaged runtime verification
• Theme consistency across windows

---

License

This project is open-sourced under the MIT License.

---

Acknowledgements

Special thanks to:

• pix2tex
• MathLive
• MathLive Compute Engine
• SymPy
• mpmath
• MathJax
• PyQt6
• QFluentWidgets

---

Download	Issues	Discussions	Wiki
Latest Release	Open an Issue	Discussions	Project Wiki