How sakuramathcraft/latexsnipper works
LaTeXSnipper is a desktop formula-recognition and editing application, with a companion Microsoft Office plugin and an Automation API. Its primary workflow takes a capture, image, PDF page, or handwriting input through recognition into a reviewable result, then supports editing, preview, copying, and export. The graph also preserves model selection, external-model documents, Office insertion/editing, and API access. Edges use README-documented workflows or the shown source-index references and excerpts; unsampled implementation details are not assumed.
Main entry points: WordPluginController.cs Word plugin · workers.py Recognition workers · coordinator.py Recognition jobs · image_input.py Image input
Components 28
Desktop experience
- App startup
src/main.py - Screen capture
src/capture/capture_controller.py - Result review
src/ui/predict_result_controller.py
Recognition
- Image input
src/recognition/image_input.py - PDF preview
src/preview/document/window.py - Handwriting input
src/handwriting/handwriting_window.py - Recognition jobs
src/recognition/jobs/coordinator.py - Recognition workers
src/recognition/workers.py
Formula workspace
- Formula editor
src/editor/workbench_window.py - Live preview
src/preview/preview_controller.py - Math preview
src/preview/math_preview.py - LaTeX rendering
src/rendering/latex.py - Formula export
src/exporting/formula_export.py - Document export
src/exporting/pandoc_exporter.py
Model runtimes
- MathCraft OCR
src/backend/mathcraft/model.py - External model
src/backend/external_model/document_pipeline.py
Integrations
- Automation API
src/integration/automation/server.py - Word plugin
office_plugin/hosts/WordAddIn/WordPluginController.cs - PowerPoint plugin
office_plugin/hosts/PowerPointAddIn/PowerPointPluginController.cs - Office API client
office_plugin/src/LaTeXSnipper.OfficePlugin.Automation/AutomationApiClient.cs - OLE rendering
office_plugin/src/LaTeXSnipper.OfficePlugin.Rendering/OlePresentationPipeline.cs - Formula metadata
office_plugin/src/LaTeXSnipper.OfficePlugin.Abstractions/FormulaMetadata.cs - Formula identity
office_plugin/src/LaTeXSnipper.OfficePlugin.Abstractions/FormulaIdentity.cs - Word settings
office_plugin/hosts/WordAddIn/WordPluginSettings.cs - Word messages
office_plugin/hosts/WordAddIn/WordAddInText.cs
Other components
- User
- Script or tool
- Office user
Connections 34
- User → Screen capture: captures screen
- User → Image input: opens image
- User → PDF preview: selects pages
- User → Handwriting input: writes formula
- App startup → Screen capture: starts app
src/main.py - Screen capture → Image input: supplies capture
- Image input → Recognition jobs: submits input
- PDF preview → Recognition jobs: requests recognition
- Handwriting input → Recognition jobs: requests recognition
- Recognition jobs → Recognition workers: dispatches jobs
src/recognition/workers.py - Recognition workers → Image input: loads images
src/recognition/workers.py - Recognition workers → MathCraft OCR: runs OCR
- Recognition workers → External model: uses configured model
- Recognition workers → Result review: publishes results
- Result review → Formula editor: opens for editing
- Formula editor → Live preview: updates preview
- Live preview → Math preview: builds preview
src/preview/preview_controller.py - Live preview → LaTeX rendering: renders formulas
src/preview/preview_controller.py - Result review → Formula export: exports formula
src/ui/predict_result_controller.py - Formula export → Document export: exports documents
- Script or tool → Automation API: submits recognition
- Automation API → Recognition jobs: coordinates jobs
src/integration/automation/server.py - Office user → Word plugin: edits in Word
- Office user → PowerPoint plugin: inserts formulas
- Word plugin → Office API client: requests OCR
office_plugin/hosts/WordAddIn/WordPluginController.cs - PowerPoint plugin → Office API client: requests OCR
office_plugin/hosts/PowerPointAddIn/PowerPointPluginController.cs - Office API client → Automation API: calls API
office_plugin/src/LaTeXSnipper.OfficePlugin.Automation/AutomationApiClient.cs - Word plugin → OLE rendering: renders OLE
office_plugin/hosts/WordAddIn/WordPluginController.cs - PowerPoint plugin → OLE rendering: renders OLE
office_plugin/hosts/PowerPointAddIn/PowerPointPluginController.cs - OLE rendering → Formula metadata: uses request metadata
office_plugin/src/LaTeXSnipper.OfficePlugin.Rendering/OlePresentationPipeline.cs - Word plugin → Formula metadata: updates formula metadata
office_plugin/hosts/WordAddIn/WordPluginController.cs - Formula metadata → Formula identity: carries identity
office_plugin/src/LaTeXSnipper.OfficePlugin.Abstractions/FormulaMetadata.cs - Word plugin → Word settings: reads settings
office_plugin/hosts/WordAddIn/WordPluginController.cs - Word plugin → Word messages: shows status text
office_plugin/hosts/WordAddIn/WordPluginController.cs