Skip to content
Skip to content
Animation & interaction

Work with the animation timeline

Use the timeline to see when a property changes, scrub through intermediate frames and compare the movement with its stored keyframes.

In this section

Read tracks and keyframes#

A track animates one property on a layer. A keyframe stores its value at a specific time. A title can have separate tracks for vertical position and opacity, even when both changes feel like one entrance.

Open Your first animation, select the first-animation timeline and inspect a named layer. This example contains 13 tracks across eight layers.

For the component screenshots below, open the simpler three-dot loading project. Its three animated dot layers each have one vertical-position track.

The Timeline panel with playback controls, the codex_loading_loop timeline, three position tracks and a playhead at 650 ms
Timeline panel only. Playback and keyframe tools sit above the time ruler; each dot has a named row and a transform.y track. The red playhead marks 650 ms in the four-second loading example.

Scrub the playhead#

Move the playhead, the marker for the current time, to inspect a frame without playing the whole scene. Compare the beginning, a midpoint and the final state of a movement. Play the sequence too: a single still frame cannot show its rhythm.

Compare timing in the Dope Sheet#

Choose the Dope Sheet tab in the bottom dock. This is a separate panel from the Dope display button inside Timeline.

Expand a layer, then Transform → y, to see the property's keyframes. Scene and layer rows summarize their child keys; the property row shows the individual channel. Compare the offset peaks across the three dots before moving keys.

The dedicated Dope Sheet panel with Animated Only and Selected Only filters, track search, Snap and the expanded Scene, layer and Transform y rows
Dope Sheet panel only. The hierarchy groups keys by scene, layer and property. The dot peaks occur at different times; summary rows repeat the same underlying keys rather than creating extra animation.

Use Search tracks to narrow the rows. Animated Only hides rows without animation, while Selected Only limits the view to the selected layer. Check Snap before dragging keys. Keep the original 180 ms stagger when following the loading-loop tutorial.

Understand frames and milliseconds#

Chorono's scene data and scripting times use milliseconds. 1000 ms is one second. At 30 frames per second, neighboring frames are approximately 33.33 ms apart. A four-second composition spans 120 frame intervals at that frame rate.

Changing the time of an end keyframe changes the duration of that movement. Changing its value changes the endpoint. Frame rate and movement duration are separate decisions.

Choose a timeline explicitly#

A scene can contain multiple timelines. Name the timeline you intend to edit in an agent brief. In a script, scene.useTimeline(id) selects the timeline for subsequent layer key operations; Timeline.key always targets its own timeline.

Timeline names such as intro, idle and outro do not automatically sequence those animations. Use explicit keyframe times for a continuous sequence, or verified interaction definitions for state transitions. See JavaScript scene scripting.

Check looping playback#

A repeating timeline must join its end back to its beginning as intended. Inspect the frames before and after the wrap. Matching positions alone does not guarantee matching speed.

Follow Looping animations to inspect a four-second scene with a resting interval at its boundary. Save and reopen your edited project before treating the revision as complete.

Chorono timeline showing the Left dot, Middle dot and Right dot vertical-position tracks with staggered keyframes
The three-dot loop is a separate, simpler example. Each dot has its own transform.y track. The diamonds show the staggered peaks and the matching resting values at the start and end of the four-second timeline.

Set keys for selected layers#

Set Key (K) uses the explicitly selected layers on the active timeline. Selecting a parent does not automatically key every child. A short click uses the current keying set. Long-press, right-click, press Up/Down on the focused button or use Shift+F10 to open its options:

Keying setChannels included
All supported channelsEvery supported keyable channel on the selection
Transform + opacityTransform and opacity channels
Existing animated channelsChannels that already have animation
Selected key channelsChannels represented by the selected keys

Choose Set keys now to apply the selected set immediately. Updating an existing key keeps its ID, easing and tangent information; newly created keys start with linear interpolation. If some channels are driven or protected, review the list and choose Set supported keys or cancel.

The transport has controls for the start/end, previous/next frame, previous/next key and first/last key. Focus matters: Left/Right step through time in the timeline, but move objects when the canvas owns the keyboard. See the shortcut table.

Use Find selected to reveal selected layers and their animation rows. Selecting a layer by itself does not repeatedly scroll the timeline. Clear all keyframes on a layer removes that layer's keys on the active timeline; a parameter-row clear affects only that channel. Neither action clears children, other timelines, controllers, modifiers or Wires.

For retiming several keys together, read collision handling before applying an overwrite.

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