Skip to content
Skip to content
Animation & interaction

Make a looping animation

A looping animation repeats a sequence. A clean loop also makes the end join the beginning without an unintended jump. In this tutorial, inspect a four-second loading animation, change its movement and save an editable copy.

EDITABLE EXAMPLE4 layers · 4s
A little progress, every day above three staggered rust circles on a cream canvas.
1.0 / 4s
Three-dot loading animation. Native Chorono playback. Repeats until paused.

Open the example#

  1. Install and start Chorono if you have not already.
  2. Preview the three-dot loading loop.
  3. Download the portable project. Save it as codex-loading-loop.chorono.json if your browser displays the JSON.
  4. Open a separate editor tab and choose Menu → Open Scene JSON. Select the downloaded file.
  5. Select the codex_loading_loop timeline and play it for at least two full cycles.

This is the existing example from the Codex guide. It uses a 1024 × 768 composition at 30 fps, four named layers, three vertical-position tracks and 24 keyframes. It has no external image, audio or font assets. You can edit it manually without an agent.

Read the loop timing#

Use the keyframe editing guide to find the property track, and the timeline guide to compare times before changing the example.

The headline stays still. Each dot starts at y = 438, rises to y = 398, then returns. Canvas coordinates increase downward, so reducing y moves a dot upward. These are composition pixels; the displayed preview may be scaled.

The following values come from the downloadable project's first wave:

LayerHold untilHighest pointBack at rest
Left dot200 ms650 ms: y = 3981100 ms: y = 438
Middle dot380 ms830 ms: y = 3981280 ms: y = 438
Right dot560 ms1010 ms: y = 3981460 ms: y = 438

Each dot follows the preceding dot by 180 ms. The second wave reaches its highest points at 2450, 2630 and 2810 ms. All three position tracks begin and end at y = 438; their last keyframes are at 4000 ms. The timeline has loop: true.

The three-dot loading project in Chorono with three staggered vertical-position tracks across a four-second timeline
Compare the three rows: each peak is offset from the row above it. The first Left dot peak is at 650 ms; the Middle dot and Right dot peaks follow at 830 and 1010 ms.

The movement uses easeInOut. In Chorono, a keyframe's easing controls the interval leaving that keyframe. The equal resting values create still intervals before, between and after the waves. See the easing comparison for how curves change progress between two values.

Reduce the movement#

Select Left dot and expand its vertical-position track. Change the two peak values at 650 and 2450 ms from 398 to 418. Keep its resting values at 438.

This reduces the upward travel from 40 pixels to 20 pixels without changing the duration. To apply the same revision to every dot, change the peaks at 830 and 2630 ms on Middle dot, then 1010 and 2810 ms on Right dot.

Keep the 180 ms delay between dots. Do not move all their peaks to the same time unless you want the dots to move together.

Check the loop boundary#

Inspect the timeline around 3967 ms, then 0 and 33 ms. At 30 fps these are approximately the neighboring displayed frames around the four-second wrap. Playback may wrap exactly 4000 ms to zero, so inspecting only the endpoint can hide the join.

Check that every dot is at rest before the wrap, that the headline remains still and that the next cycle begins as intended. Play at least two cycles after the revision.

Matching endpoint positions prevents a positional jump, but does not guarantee smooth speed. This example has a resting interval at the boundary. For a continuously moving loop, also check direction and speed across the join.

Make the same edit with an AI agent#

After connecting the editor through MCP, give your agent a specific revision:

Read the open three-dot loading scene and the codex_loading_loop timeline. On Left dot, Middle dot and Right dot, change only the two peak y values from 398 to 418. Keep all resting y values at 438, the existing keyframe times, easeInOut easing, the 180 ms stagger, headline and four-second loop. Preserve unrelated layers and timelines. Inspect real previews near 0, 1000, 3000 and 3967 ms, validate and save a separate portable revision. Report the path.

The download contains the original 40-pixel movement. This prompt describes a revision you make after opening it.

Save and reopen your revision#

Choose Menu → Save Scene JSON and use a name such as loading-loop-small-motion.chorono.json. Reopen that file in a separate editor tab and check the changed peaks and the loop boundary again.

Keep the portable project as the editable source. A runtime export is a separate playback artifact; it is not an MP4 file or a ready-made accessible loading component.

Use a loading loop responsibly#

This animation is a motion study, not a measurement of a running task. In an application, show a loading state only while work is pending and stop it when the operation finishes. Use a determinate progress bar when you can report actual progress.

Keep status text outside a canvas, provide playback controls for demonstrations and respect reduced-motion preferences. For a simple three-dot indicator, CSS may satisfy the application better; Chorono is useful when you need an editable scene or coordinated motion.

Next, compare progress and success animations, or inspect the keyframes in a title entrance.

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