Skip to content
Skip to content
Formats

Export Chorono runtime JSON

Runtime JSON packages scene data for playback in an application. Keep an editable source copy, export the runtime package, and check its diagnostics before using it with the player.

Export the package#

  1. Save an editable project.
  2. Choose Export → Runtime JSON (lean), or Runtime in an older toolbar.
  3. Read any export warnings. Validation failures prevent a usable package from being produced.
  4. Open the downloaded JSON and inspect its runtime and warnings fields.

The package is produced by the editor's runtime exporter. It is different from the legacy runtime representation exposed by the JSON inspector. Do not select a schema based only on the .json filename.

Load the runtime payload#

The website's examples use this package shape:

const response = await fetch('/animation.runtime.json')
if (!response.ok) throw new Error('Runtime export could not load')
const exported = await response.json()
console.log(exported.warnings)

const player = new ChronoPlayer(
  exported.runtime,
  new CanvasRenderAdapter(context),
  { loop: true }
)

See the JavaScript runtime guide for imports, canvas setup, playback controls and cleanup. The constructor receives exported.runtime, not the wrapper object.

Review warnings and assets#

Warnings describe compatibility or delivery concerns found during export. Review them individually; a successful download does not guarantee that every editor feature is implemented by the installed player.

Make referenced assets reachable from the deployed application. Temporary browser URLs are not durable hosting addresses. For media scenes, load the assets required by the runtime API and test browser access and fonts in the real target environment.

Verify playback#

Pin the runtime version, then compare the first frame, a middle frame, the end and the loop boundary. Exercise state-machine events and parameters if the scene uses them. Retain both the editable source and the tested runtime export so a later edit can be exported and checked again.

Check procedural motion on the target runtime#

The full-scene web player and simpler or native runtimes have different capabilities. A project that works in the editor is not automatically supported by every runtime package.

Review diagnostics for live expressions, controllers, modifiers and assets. Use an explicit conversion or bake to keyframes only when it fits the target. Numeric, color and point expression bakes produce linear keys; boolean and text bakes produce hold keys. Those editor results do not establish universal support for hold keys or all property types in other formats.

Test the downloaded payload with the exact runtime version and platform you will ship. Check the start, middle, end and any interaction-dependent states, using the runtime's documented installation and capability guide.

A good place to start
Getting started / Chorono documentationChorono documentationLearn Chorono with editable animation examples. Install the editor, edit keyframes, build loops and connect Claude Code or Codex through MCP. Cre…Getting started / Install ChoronoInstall ChoronoSet up the free, open-source animation editor on your computer and start a local browser session. This guide installs the browser editor, its loc…Getting started / Create your first editable animationCreate your first editable animationOpen an editable Chorono example, change its text and colors, inspect the timeline, then save and reopen your first 2D animation. Start with a re…Workspace / Chorono editor workspaceChorono editor workspaceFind the canvas, layers, properties, timeline and resource tools in the Chorono editor. Choose a guide for each part of your animation workflow.…Workspace / Canvas and drawing toolsCanvas and drawing toolsNavigate the canvas, draw shapes and splines, use snapping and edit motion keys in Chorono. Use the canvas to arrange the objects in your composi…Workspace / Choose a drawing or transform toolChoose a drawing or transform toolUse Select, Pan, Pen, Move, Rotate, Scale and Anchor tools without losing track of the active editing mode. Choose the tool that matches the edit…Workspace / Select exactly the objects you needSelect exactly the objects you needUse box, lasso, circle, paint and rule-based selection to work with several animation layers. When several objects overlap, clicking each one can…Workspace / Align objects with guides and snappingAlign objects with guides and snappingSet grid, object, point, guide, pixel, angle and scale snapping for precise placement in Chorono. Snapping helps a dragged object settle on an ex…Workspace / Edit Bézier points and spline curvesEdit Bézier points and spline curvesDraw editable paths, adjust points and handles, and extend or close a spline in Chorono. A curve is easier to control when you can see the points…Workspace / Edit animation positions on the canvasEdit animation positions on the canvasUse Motion Keys to adjust position keys, draw a movement and control how the path is timed. Motion Keys bring position editing onto the canvas. T…Workspace / Layers and scene hierarchyLayers and scene hierarchySelect, name, group and organize scene objects in Chorono using the Layers panel and Scene Explorer. A layer is an editable object in your Choron…Workspace / Draw and edit basic shapesDraw and edit basic shapesCreate rectangles, circles, polygons and procedural shapes, then adjust their geometry in Properties. Basic shapes are a useful starting point fo…
Explore the docs