mcpField
T
tesseract-editor

tesseract-editor

github.com/mirage-hqDevelopment1621.3k installsUpdated 1d ago
Repository

About tesseract-editor

tesseract-editor is a skill for building browser-based editors for Tesseract `.tsrct` projects. It describes local project loading, preview, editing, and saving through the browser runtime, while noting that video export is not supported there.

Key features

  1. 01Open and preview `.tsrct` projects locally
  2. 02Edit using the browser engine API
  3. 03Save documents and original assets to a Blob
  4. 04Use engine actions and grouped edits
  5. 05Match runtime assets to a release

Use cases

  1. 01Build a static HTML Tesseract editor
  2. 02Add playback and selection controls
  3. 03Save edited project documents locally

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mirage-hq/tesseract --skill tesseract-editor

After installing, type/tesseract-editorin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
assets/
icon.svg
examples/bouncing-ball/
app.js
ball.tsrct
index.html
motion.js
README.md
style.css
examples/timeline-editor/
app.js
index.html
README.md
style.css
references/
browser-api.md
cli-version.txt
conversion.md
installation.md
versions.md

Details

From the project README

Build a Tesseract editor

If the editor needs to import or export other tools’ project formats, such as Premiere Pro or After Effects, read conversion. When opening shared or older .tsrct files, updating tools, or investigating load/render differences, read versions and compatibility.

The browser engine opens, previews, edits, and saves .tsrct projects locally. A static HTML application is sufficient; no backend or native CLI is required. The browser runtime does not export video.

The browser API reference covers initialization, actions, playback, and saving. Examples: general layer controls and controls for a bundled project.

Runtime and serving

references/cli-version.txt, when present, pins the browser runtime release too. The installation reference identifies the release repository. The browser assets are tesseract-<VERSION>-web.zip and its .sha256; verify the checksum before use. The archive contains runtime/, used beside index.html in the examples. Its generated JavaScript, types, and WASM must come from the same release. No npm installation is needed. version() returns the runtime release.

The editor needs HTTP serving and browser GPU/media support. Its HTML depends on the runtime files; attachment viewers may not execute WASM. CLI or skill updates do not require upgrading an existing editor’s runtime.

Editing and saving

actionSchema() describes supported engine actions. UI controls, playback scheduling, and selection gestures belong to the application. Await rendering so frames do not overlap; edit groups combine continuous changes into one history entry.

TesseractEngine.create(file) accepts a File or Blob. toBlob() packages the current document with its original assets; it does not write to disk. Overwriting the source file can invalidate asset reads; the API reference describes reopening the saved Blob. Page refresh discards unsaved edits.

Comments

Markdown supported