Animate with the timeline

The timeline answers two questions: what changes and when it changes. Use a preset for a quick entrance or exit; use property keyframes when position, scale, rotation, opacity, or another property must change at exact moments.

Activeuserdesktopmobile20–30 minutes

Verified against frontend@2.0.0

Product UI verification

The Desktop controls and screenshot callouts in this guide were checked against the real local editor at a 1440 × 1000 viewport through 27 July 2026. The screenshots show the production canvas, properties inspector, timeline, and drawer UI—not a documentation playground.

When to use each timing tool

Need	Best starting point	Why
Make an object appear, move, or leave quickly	Preset Animation	One control creates a reusable timing range
Coordinate several exact property values	KEYFRAMES drawer	Keys preserve explicit values at explicit times
Refine acceleration or deceleration	CURVES drawer	The curve exposes interpolation between keys
Reveal vector artwork stroke by stroke	DRAW drawer	Draw steps, not ordinary property keys, own reveal timing
Change framing	CAMERA drawer	Camera state remains separate from object geometry
Align narration or music	Audio lane	Waveforms and scene/project tracks provide the timing reference

Do not add keyframes merely because the timeline is available. A simple preset is easier to maintain when it already produces the intended result.

Before you start

1. Open a project with at least one scene and one object.
2. Stop playback before changing scene structure or timing.
3. Select the scene and object you intend to animate.
4. Confirm that the object is unlocked.
5. Export a .scribe backup before reorganizing many keys or shortening scenes.

Mobile Lite exposes the same project timing through a compact timeline and the Animate sheet. Dense curve and multi-track work is easier on Desktop.

Timeline and inspector anatomy

12345

A selected object connects the canvas, properties inspector, object track, and timeline drawers.

Screenshot callouts

1. 1
   Selected object and transform bar

   The canvas selection decides which inspector sections and selected-only tracks are available.
2. 2
   Properties inspector

   Basics, layer order, type-specific properties, preset animation, and object camera live here.
3. 3
   Transport and timeline tools

   Play, stop, loop, speed, search, editing actions, fit, zoom, and pop-out controls.
4. 4
   Object track and time ruler

   The horizontal lane shows the object timing range; the ruler and playhead establish time.
5. 5
   KEYFRAMES, CURVES, CAMERA, and DRAW

   Open the domain-specific editor without leaving the shared timeline.

Visible controls

Area	Control	What it does
Canvas transform bar	Duplicate and delete icons	Copies or removes the selected object
Canvas transform bar	Scale, Position, 0deg, Reset	Changes the active transform mode or restores the transform
Inspector	Basics	Names the timeline item and provides exact position and details
Inspector	Layer Order	Changes stacking relative to other scene objects
Inspector	Type-specific section, such as Text	Edits content-specific properties
Inspector	Preset Animation	Sets animation type, start, duration, and easing
Inspector	Object Camera	Configures eligible object-follow camera behavior
Transport	Play, stop, loop, and speed	Controls preview without changing the authored values
Transport	Search tracks	Filters a large track list
Transport	Copy, paste, group, fit/reset, zoom, and pop-out controls	Edits or changes the timeline view; disabled controls require a compatible selection
Drawer tabs	KEYFRAMES, CURVES, CAMERA, DRAW	Switches the right-side editor
KEYFRAMES filter	All keys, Selected only, Follow playhead	Controls which keys appear and whether the inspector follows time
KEYFRAMES actions	+ ADD @ PLAYHEAD, COPY, PASTE @ PLAYHEAD, DELETE	Creates or edits the current key selection

Tutorial 1: apply a preset animation

Use this for a straightforward entrance, emphasis, or exit.

1. Select an object on the canvas or its track.
2. In the right inspector, expand Preset Animation.
3. Set Start Time (seconds). This is scene-relative for the selected object's preset timing.
4. Set Duration (seconds).
5. Choose an Animation Type.
6. Choose Easing:
   • use a simple ease for natural starts and stops;
   • use linear motion for constant-speed technical movement;
   • avoid a dramatic easing curve when precise synchronization matters.
7. Move the playhead to just before the start.
8. Press Play and watch through the end of the range.

Expected result: the object track shows an authored timing range, and the canvas preview changes only inside that range.

Timing source

The inspector can report that timing is controlled by Draw Steps, property keyframes, an audio-bound segment, or multiple sources. Edit the owning source instead of forcing preset start and duration fields.

Tutorial 2: create property keyframes

Use keys when the object must reach exact values at exact times.

1. Select the object.
2. Open KEYFRAMES.
3. Move the playhead to the first time.
4. Choose + ADD @ PLAYHEAD and select or create the supported property track.
5. Set the initial value in the key editor or inspector.
6. Move the playhead to the second time.
7. Change the property and add or update the second key.
8. Repeat only for meaningful changes.
9. Select a key to edit its time or value.
10. Use COPY and PASTE @ PLAYHEAD to reuse a key at a new time.
11. Use DELETE only after confirming the selected key or keys.

Expected result: the time ruler shows keys on the object's property track, and scrubbing interpolates between compatible values.

Selection and navigation rules

• All keys is best for understanding the complete scene.
• Selected only reduces noise when several objects have keys.
• Follow playhead is useful during inspection, but turn it off if automatic focus interrupts manual editing.
• Zoom in before moving short or closely spaced keys.
• Copying a key copies its property value; pasting at the playhead changes its time.
• A locked object can remain visible while its authoring controls are unavailable.

Tutorial 3: refine easing with curves

1. Create at least two compatible property keys.
2. Select their track or keys.
3. Open CURVES.
4. Choose the property curve.
5. Adjust interpolation or handles gradually.
6. Hold Space while dragging when the curve editor uses pan mode.
7. Use X or Y constraints when the active curve interaction supports them.
8. Press Escape to cancel an in-progress drag.
9. Preview the motion at normal speed.

Expected result: the start and end values remain the same while the speed between them changes.

Avoid extreme handles that create overshoot, abrupt reversals, or a value outside the object's valid range.

Timing-source combinations

One object can carry a preset, property keyframes, draw-progress keyframes, Draw Steps, and a visible range at the same time. These sources are not averaged together. Each source owns a different part of the result, and a higher-authority source can replace a lower-authority value.

“Mixed” does not mean blended

The Mixed timing-source badge means that more than one timing domain contributes to the object, commonly property keyframes plus Draw Steps. It does not mean Scribe blends every animation into a new effect.

What each source owns

Source	What it owns	Important boundary
Preset Animation	One object-level effect, start, duration, and easing	An object has one preset slot. Choosing Fade In, Scale In, Slide In, or Draw In replaces the previous preset type
Draw In	Preset-driven reveal progress for an eligible path-backed object	It is a Preset Animation type; selecting it does not create Draw Steps
draw.progress keyframes	Explicit reveal progress at exact times	They replace preset-driven reveal progress unless a targeted Draw Step is active
Draw Steps	Scene-local reveal order, start, duration, hand/tool choice, and optional step camera	A targeted Draw Step has final authority over reveal progress
Property keyframes	Exact values such as position, scale, rotation, or opacity	A keyframe overrides the preset only for the same property; unrelated properties still combine
Explicit or audio-bound visible range	The outer interval used to constrain and fit the object's authored timing	It is not an automatic exit animation and does not hide the object at the range end by itself

At each preview time, Scribe evaluates the object in this order:

1. Calculate the selected preset.
2. Apply property keyframes. A matching keyed property replaces the preset's value for that property.
3. Resolve draw progress from Draw In or a draw.progress track.
4. If the scene Draw plan targets the object, use the Draw Step progress instead.
5. Apply the explicit or audio-bound visible-range constraint and any required timing rebase.

Audio binding does not add another visual animation layer. It fits or constrains the existing sources. See Audio binding for the action-specific rules.

12345

One real object carries Draw In, Position.X keys, and Draw Steps. Mixed reports multiple timing owners; it is not a simulated combined animation.

Screenshot callouts

1. 1
   The same selected vector

   The canvas, inspector, object track, and drawer all refer to this one object.
2. 2
   Timing Source: Mixed

   Read this message before editing disabled or apparently ineffective preset timing fields.
3. 3
   Draw In is the active preset

   Choosing another preset replaces Draw In in the single preset slot; it does not remove stored keys or Draw Steps.
4. 4
   Mixed object range

   The object range summarizes the active timing domains instead of extending every source to the same duration.
5. 5
   Position.X remains independently keyed

   The two keys own horizontal position while the reveal source owns draw progress.

Same-object combination matrix

Combination	Runtime result	Timing to edit
Preset only	The preset controls its effect for its start and duration	Preset Animation
Draw In only	Preset timing drives reveal from 0% to 100%	Preset Animation
Fade In + opacity keys	Opacity keys win; the preset's opacity curve is replaced	Opacity property track
Fade In + position/scale keys	Fade opacity and the unrelated keyed transform combine	Preset for fade; property tracks for transforms
Scale In + scale keys	Scale keys win over preset scale	Scale property track
Scale In + opacity/position keys	Preset scale combines with the unrelated keyed properties	Both sources independently
Slide In + X/Y keys	A keyed axis wins; any unkeyed slide axis can remain	Position tracks for keyed axes
Draw In + draw.progress keys	The keys drive reveal instead of preset progress	Draw-progress property track
Draw In + Draw Steps	Draw Steps drive reveal; preset start/duration no longer own the draw schedule	DRAW drawer or Draw range
Draw In + Draw Steps + draw.progress keys	Draw Steps win while they target the object; stored draw-progress keys become active again if those steps are removed	DRAW first, then the draw-progress track
Draw In + transform/opacity keys	Reveal and unrelated property motion combine	DRAW or Draw In for reveal; property tracks for motion
Draw Steps + Fade/Slide/Scale	Step timing remains stored, but the eligible vector stroke renderer requires Draw In for a true stroke reveal	Choose Draw In when reveal is intended; otherwise review whether the steps should remain
Property keys + Draw Steps	The badge reports Mixed; keys control their properties and steps control reveal	Edit each owning drawer separately
Any source + explicit/audio-bound visible range	Existing timing is constrained or fitted inside the outer range	Visible-range owner or the bound script segment

Draw Steps are sampled linearly. Current Draw Steps do not have their own easing field; add property keys only when you need an independently eased property, not to imitate step progress.

1234

The DRAW drawer shows why the object is Mixed: Draw Steps own reveal progress while Position.X keys remain a separate property source.

Screenshot callouts

1. 1
   Mixed source remains visible

   The inspector warns that no single preset range owns the complete object timing.
2. 2
   Draw In enables stroke reveal

   The preset supplies drawable rendering behavior; the targeted step supplies authoritative progress.
3. 3
   Mixed timeline range

   The range represents the keyframe and Draw Step domains associated with the selected object.
4. 4
   Draw Steps are the reveal authority

   Steps are ordered by their authored start times; the active step interpolates and completed steps hold their final progress.

Build a deliberate combination

1. Select one object and decide the intended visual result before adding timing sources.
2. Choose one Preset Animation. If the object must be drawn, use Draw In on a supported path-backed vector, drawing, Smart Line, or Smart Arrow.
3. Add property keys only for values that the preset does not already control—or intentionally replace the preset property with keys.
4. For ordered drawing, create or Auto-plan Draw Steps in DRAW. Draw In does not create them automatically.
5. Re-select the object and read Timing Source in the inspector.
6. Inspect the owning ranges in KEYFRAMES and DRAW. Do not assume the preset Start and Duration fields own a Mixed range.
7. Scrub before, inside, and after every source boundary, then preview at normal speed.
8. If audio binding is required, bind only after the visual timing is stable; then verify which sources the binding action fitted.

Diagnose an unexpected mixed result

1. Temporarily inspect one source at a time; do not delete anything yet.
2. If opacity, scale, or position differs from the preset, look for a matching property track.
3. If stroke progress differs from Draw In, look first for targeted Draw Steps, then for a draw.progress track.
4. If timing fields are disabled, read the timing-source message and edit the named owner.
5. If a removed Draw Step seems to change the animation again, remember that the stored lower-priority draw-progress keys or preset become active.
6. If an audio-bound source cannot move outside a range, inspect or remove the binding. Use Undo immediately when the pre-fit arrangement matters.

Current limitations

• Multiple Draw Steps are ordered by start time and stable ID. They do not create per-step easing.
• The default Draw Auto-plan can keep existing timing instead of changing an incompatible preset. Verify that Draw In is selected when you expect a stroke reveal.
• Typewriter is text-specific. Draw In requires drawable path data.
• The end of a visible range does not create an exit or automatic hide; author an exit/visibility change explicitly when needed.
• A static SVG export contains no preset, keyframe, Draw Step, visible-range, or audio timing.

Tutorial 4: coordinate scenes, drawing, camera, and audio

1. Set scene durations before detailed synchronization.
2. Add narration or the primary audio reference.
3. Place object presets and keys inside their intended scene.
4. Open DRAW for stroke-reveal timing.
5. Open CAMERA for framing and camera keys.
6. Preview across the next scene boundary.
7. Check that no draw step, camera move, key, or important audio clip is cut off.
8. Export a short test before final delivery.

The same time can be represented in different scopes. Scene controls usually show scene-local time; the shared project playhead is global. If an edit lands in the wrong scene, verify which scope the active field expects.

Limitations and safety

• Preset timing does not replace property keyframes, draw steps, camera tracks, or audio clip timing.
• A static SVG export does not preserve animation timing.
• Closely packed keys can become difficult to select at low timeline zoom.
• Shortening a scene can hide or truncate authored content without deleting its data.
• Property interpolation requires compatible numeric or supported values.
• Playback may intentionally disable structural editing.
• Mobile Lite prioritizes focused object timing and can condense advanced Desktop controls.
• Undo immediately after a risky timing edit; export a package before bulk restructuring.

Troubleshooting

Problem	What to check
No object track appears	Confirm the object belongs to the active scene, is selected, and is not filtered out
+ ADD @ PLAYHEAD is disabled	Select a compatible object/property and stop playback
Animation starts in the wrong scene	Check scene-relative versus global time and the active scene
Preset timing fields cannot be edited	Read the timing-source message; Draw, keyframes, or audio may own the range
Motion jumps	Look for duplicate-time keys, very short intervals, or extreme easing
Key cannot be moved	Unlock the object and check for audio-bound or domain-owned timing
Preview differs after a scene edit	Replay across the entire scene boundary and verify camera/draw/audio ranges
Timeline feels crowded	Filter to selected tracks, search by object name, and zoom the time scale

Related workflows

• Create drawing-hand reveals
• Use camera moves and path following
• Add voiceover, music, and synchronized audio
• Timeline Complete Guide
• Mobile Lite Timeline