Skip to Content
Starlight

Timeline

The timeline shows when things happen: when each layer is on screen, and where its keyframes are. Press ⇧T / Shift+T to open it. It has two views: the layers view and the curves view.

Words on this page

These words appear in the timeline sections below.

Layer
Something drawn on a surface: a text, an image, a video, a shape and more. In the node graph each layer is a node.
Surface, comp
A surface is one LED output (N, E1, S and more). A comp is a named group of layers you can place on surfaces.
Keyframe (key)
A value at a moment in time. Starlight animates a property by moving it from keyframe to keyframe.
Lane
One row of keyframes: one animated property of one layer.
Bar, clip
The bar shows when a layer is on screen. The bar of a video or audio layer is its clip.
In point, out point
Where a bar starts and ends. Together they are the layer's span in the YAML.
Playhead
The red line that marks the current time. The transport plays and moves it.
Edit point
A time that ↑ and ↓ jump to. It is the start or the last frame of the loop, an in or out point, a marker, or an edge of the work area.
Gate
A lane that turns a layer on and off over time (gate).
Ease
The shape of the motion between two keyframes (Eases).
Curves view
The timeline's second view. It shows the curves of the selected animated layer, one lane under the other (Edit in the curves view).
Curve
A line that shows how a value changes over time. It goes through the keyframes and follows their eases.
Handle
A small dot at the end of a thin line, next to a selected keyframe. Drag it to shape the curve (Shape a curve with handles).
Hint
A short message in the middle of the panel's header. It says what an action did, or why it did not work (Read the hint).

Open the timeline toggle ⇧T / Shift+T

Open the timeline panel at the bottom of the window, and choose one of its two views.

  1. Press ⇧T / Shift+T, or choose Window › Timeline.
  2. To switch views, click one of the two small icons at the left of the panel's header. The bars icon is the layers view. The curve icon is the curves view. Or press ⌥T / Alt+T.
  3. To close the panel, press ⇧T / Shift+T again, press Esc, or click × at the right of the header.
  • The layers view shows every layer of one surface or comp. The curves view shows only the selected layer's curves and keyframes.
  • The icon of the active view is lit. Point at an icon to see its name and key, for example curves — the selected layer's curves · ⌥T.
  • Both views show the same animation. An edit in one view shows at once in the other view and on the canvas.
  • The panel opens in the view you used last. Starlight remembers it for each project.
  • The curves view needs an animated layer. If none is selected, the panel stays on the layers view. A message says curves: select an animated layer first.
  • Your view can be the curves view while no animated layer is selected. Then ⇧T / Shift+T opens the layers view. Your view stays the curves view.
  • When curves is your view, the panel opens by itself when you select an animated layer. It hides while the selected layer has no animation.
  • Right-click an animated layer on the canvas or in the graph and choose open in timeline. The panel opens on that layer.
  • In Properties, the right-click item reveal in timeline opens the panel on that property's lane. It does not change your selection or your chosen view.
  • The links to a lane's curve (∿ on a lane, a double-click on a keyframe, and edit curve…) open the curves view, and the panel stays open. They do not change your chosen view (Open a lane's curve).
  • A link (∿, open in timeline) can show the other view for a short time. When you close the panel, it goes back to your chosen view. The next ⇧T / Shift+T opens your chosen view, and a reload does too.
  • The command palette has the same commands: toggle timeline and timeline: layers / curves.
  • Drag the top edge of the panel to make it taller or shorter.
  • While the panel is open, the thin progress bar at the bottom of the window hides. The panel has its own playhead.
  • The panel needs an open scene.

Read the layers view

The layers view lists every layer of one surface or comp, with the front layer at the top.

PartWhat it shows
Two icons: bars · curveThe two views, at the left of the header: the layers view and the curves view. The lit icon is the active view (Open the timeline).
Picker beside themWhich surface or comp the rows show. It lists each surface (for example surface N) and each comp (for example comp main). When you select a layer on the canvas or in the graph, the timeline moves to the comp that holds it.
Middle of the headerThe playhead time, the loop length · fps (for example 8s · 30fps), and the hint (Read the hint).
Right of the headerrows (row height), snap (snapping), ⚑ n (markers) and × (close). A highlighted button is on.
Corner at the left of the rulerHow many layers the surface or comp has, for example 5 layers.
SwitchesFour switches at the left of each row (Hide, solo or lock a layer).
NameThe layer's name. A long name is cut in the middle, and its number at the end stays. Hover it to read the whole name. ▸ opens the layer and ▾ closes it. ↳ goes inside a comp (Go inside a comp).
BarWhen the layer is on screen in the loop. A full bar means the whole loop. Darker parts are where a gate hides the layer (gate).
Bar colour and outlineThe bar has the layer's colour from the graph. A dashed bar is a hidden layer: a bypassed picture, shape, text or video, or a use of a bypassed comp. A bypassed transform or group still draws its layers, so its bar stays solid. A dim bar is a locked layer.
Ticks on a barThe keyframes of a closed layer.
▸Opens the layer. It lists the animated properties, the gate, the audio drives, the effects and a group's child layers.
LaneOne animated property. Its keyframes are diamonds. Its name shows the value at the playhead, then the buttons ∿ ‹ ◇ ›. ∿ opens the lane in the curves view.
Effect rowOne effect on the layer, with its own fx switch. Its ▸ opens the effect's animated settings.
follows audio rowA property that an audio band moves, for example scale ← kick (drive). It has no keyframes.
Audio rowA waveform instead of a bar.
Comp rowA comp that a surface shows. It has a full bar and ↳.
RulerThe time, at the top of the tracks. Click or drag it to move the playhead.
Faint linesA line down the rows for each marker, in its colour. Faint ticks show where a clock starts again, and where the beats are.
  • Times show in seconds or frames. To switch, click the time in the transport row (Show seconds or frames).
  • With nothing selected, the timeline starts on the first surface. If that surface only shows a comp, it starts on that comp.
  • An empty surface or comp says no layers in this scope.

Go inside a comp

See and edit the layers inside a comp that a surface shows.

  1. Find the comp's row. A surface that shows a comp lists the comp as one row, for example comp main.
  2. Click ↳ on that row, or double-click its name. The rows now show the layers inside the comp.
  3. To go back, pick the surface in the picker at the left of the header.
  • A comp placed as a layer (with use:, or a cloner of a comp) also has ↳. On such a layer, a double-click on the name does not go inside. Use ↳.
  • A click on a comp row does not select anything. So you do not go inside by accident.
  • The tooltip of ↳ says enter comp and the comp's name.

✥ rows: a layer and its transform

A placed image, text or gradient shows as one row, marked ✥, that stands for two nodes.

  • The two nodes are the content (for example the image) and the transform that places it. The transform holds the position, scale, rotation and opacity.
  • The row has the name of what it places, for example ✥ image collage-….
  • Click the row to select the transform. A click on the canvas does the same.
  • Sometimes only the content is animated, for example a shape that grows while its transform stays still. Then the curves view shows the content's curves when you select the row.
  • Open the row with ▸. Small headings show whose lanes are whose: transform, the kind of content (for example image, text or gradient) and effects.
  • Other layers show these headings too when their lanes come from more than one place.
  • Click a small heading to select that node. Hold ⇧ / Shift to add it to the selection or take it out. On a Mac, ⌘ works too.
  • An in point or out point that you set goes on the content.

Select layers and keyframes

Select layers and keyframes in the timeline. It is the same selection as on the canvas and in the graph.

  1. Click a layer's name or bar to select it.
  2. To select a range of layers, hold ⇧ / Shift and click another layer's name.
  3. To add or remove one layer, hold ⌘ / Ctrl and click its name.
  4. To select with a box, drag on an empty part of the tracks. The box selects the layers and keyframes it touches.
  5. Click a keyframe to select it. Hold ⇧ / Shift and click to add or remove keyframes.
  • Hold ⇧ / Shift or ⌘ / Ctrl while you drag a box to add to the selection.
  • To start a box on top of a bar, hold ⇧ / Shift when you press. A ⇧ / Shift-click on a bar, with no drag, adds or removes that layer.
  • A ⌘ / Ctrl-click on a bar that is not selected adds it to the selection.
  • Hold the box at the top or bottom edge of the rows to scroll them. Press Esc to cancel the box.
  • A box that touches only keyframes keeps the selected layers. A box that touches nothing clears the selection.
  • Audio rows have no bar, so a box never selects them.
  • Click an empty part of the tracks to clear the selected keyframes, and then the layers.
  • Esc clears the keyframes first. With the pointer over the panel, it then clears the layers. The next Esc closes the panel.
  • Right-click a bar and choose select all after the playhead or select all before the playhead. On the ruler these items are select all after here and select all before here.
  • After selects the layers that start at or after that time. Before selects the layers that end at or before it.
  • A layer you select on the canvas or in the graph lights up here, and the rows scroll to it.

Hide, solo or lock a layer

Four switches at the left of each layer row change how the layer shows.

SwitchWhat it doesSaved?
◉ eyeBypass: switch off what the layer adds. A picture, shape, text or video hides. A transform or group keeps showing its layers, without its own position, animation and effects. The eye shows ○ while it is bypassed. The key b does the same (Turn a node off).Yes, and you can undo it
fxBypass every effect on the layer. It shows only on layers with effects. An open effect row has its own fx for that one effect.Yes, and you can undo it
● soloShow only the soloed layers, so you can check them alone.No
⊘ lockThe canvas ignores clicks on the layer, and the timeline does not edit it (layer locked). You cannot delete it either.No
  • Solo and lock are only for previews. They are not saved, you cannot undo them, and exports never use them.
  • You can solo several layers. They show together.
  • Solo acts inside one surface or comp. A comp with no soloed layer is not changed.
  • A lock also locks the layers inside it. Their lock switch shows a small dot (·).
  • You can still select a locked layer in the timeline or in the graph.
  • A locked layer cannot be deleted. ⌫ / Backspace and delete in the canvas and node graph menus do nothing to it. The notice says layer locked: unlock it in the timeline to delete it. This is also true for a layer inside a locked layer, and for an effect on either.
  • If a selection has locked and unlocked layers, the unlocked layers are deleted. The notice says, for example, 1 locked layer kept. To delete a locked layer, click its ⊘ switch to unlock it first.
  • Point at a switch to see its tooltip, for example solo · preview only, never exported.

Change the layer order

Move a layer in front of or behind other layers, or into a group.

  1. Press on the layer's name.
  2. Drag up or down. A line shows where the layer will go.
  3. Release in the top half of another layer to put it in front of that layer. Release in the bottom half to put it behind.
  4. Or release on the middle of a group row to put the layer inside it, at the front. A box around the group's name shows this.
  • The rows go from the front (top) to the back (bottom).
  • A transform row that holds more than one layer takes layers too. A ✥ row does not.
  • This is the same move as in the node graph, and it is one undo step.
  • If the drop is not possible, a dashed red box shows on that row. When you release there, the hint says can't drop there.
  • A locked layer does not move (layer locked). Press Esc during the drag to cancel it.

Move the playhead in the timeline

Move the playhead from the timeline. Play, pause and frame steps are in Transport and playback.

  1. Click or drag in the ruler at the top of the tracks. Playback pauses, and the playhead lands on a frame.
  2. Or scroll over the time in the timeline's header. One click of the mouse wheel moves one frame, and ⇧ / Shift moves 10 (Scrub to a time).
  3. Double-click the time in the timeline's header to go to the first frame. The play state does not change: playing or paused (Go to the first or last frame).
  4. Click ‹ or › on a lane to go to its previous or next keyframe.
  5. Click a marker's flag to go to that marker.
  6. With the pointer over the layers view, press ↑ or ↓ to go to the previous or next edit point.
  • An edit point is the start or the last frame of the loop, or a layer's in or out point. Markers and the edges of the work area are edit points too.
  • At the first or last edit point, the hint says at the first edit point or at the last edit point.
  • With no keyframe in that direction, the hint says no earlier keyframe or no later keyframe.
  • With the pointer over the layers view, ← and → step one frame when no keyframes are selected. Hold ⇧ / Shift to step 10 frames.
  • The transport keys work here too (Transport keys). j and k go to the previous and the next keyframe. , and . step one frame, and Space plays or pauses. Home and End jump to the first and the last frame. ⇧F / Shift+F jumps to the first frame and does not stop playback.
  • While the scene plays, the view moves along with the playhead.

Zoom and scroll time

Zoom in on a short moment, or see the whole loop.

  1. Put the pointer over the tracks.
  2. Scroll, or pinch on a trackpad, to zoom in or out around the pointer.
  3. To move in time, hold ⇧ / Shift and scroll, or swipe sideways on a trackpad.
  4. Press 0 (the 0 above the letters) to fit the whole loop. Press + or - to zoom around the playhead. The keypad's 0 is the RAM preview.
  • Scrolling with ⇧ / Shift also moves the rows up and down. Scrolling over the layer names scrolls the rows.
  • = also zooms in, and _ also zooms out. If the playhead is out of view, these keys zoom around the middle.
  • These keys zoom the timeline only with the pointer over it. Elsewhere, + and - zoom the canvas.
  • You can zoom out until the whole loop fits. You can zoom in until one frame is 80 px wide.
  • Each scene remembers its zoom, its scroll and the paused playhead.

Set a value at the playhead

Change an animated property at the current time. The lane gets a keyframe there.

  1. Open the layer with ▸. Each lane shows its value at the playhead beside its name, for example rotate 8.4°.
  2. Move the playhead to the time you want.
  3. Click the value, type a number and press ⏎ / Enter.
  • You can also press ↑ or ↓ in the field (with ⇧ / Shift, 10 times the step). Or drag it with the middle mouse button for the value ladder (Change a value).
  • If a keyframe is at the playhead, it takes the new value. If not, Starlight adds a keyframe there.
  • The value changes live while the scene plays.
  • A transform lane shows the layer's value, the same number as Properties. A keyframe holds an offset: Starlight adds it to the layer's fixed (static) value. For scale and opacity, it multiplies the fixed value instead.
  • So a keyframe of −30 on a layer at y 600 shows y 570, in the lane and in Properties. Point at the value to see both parts, for example = base 600 + offset −30.
  • Type the value you want the layer to have. Starlight works out the keyframe's offset.
  • A gate lane shows no value. A colour lane (a gradient stop's colour, a shape's fill or stroke, or a text's fill) shows its colour code, and you cannot change it here.
  • A locked layer's values show as plain text, and you cannot change them here.

Add, move and delete keyframes

Add keyframes to a lane, change their time, and delete them.

  1. Start the animation in Properties: click the property's ◇ (Keyframe a property). Its new lane opens here.
  2. To add a keyframe, double-click the lane at that time. Or move the playhead there and click ◇ on the lane's name.
  3. To change a keyframe's time, drag it left or right.
  4. To nudge the selected keyframes one frame, press ← or →. Hold ⇧ / Shift for 10 frames.
  5. To delete the selected keyframes, press ⌫ / Backspace or Delete.
  • A new keyframe takes the value the animation already has at that time, so nothing jumps. It gets the ease smooth.
  • ◇ on a lane's name removes the keyframe at the playhead, if there is one. On a gate lane it turns the gate on or off from that time.
  • A dragged keyframe lands on whole frames, or on a target nearby (snapping). Hold ⌘ (Mac) / Ctrl (Windows) to turn the targets off (or on). Hold ⌥ / Alt to place it freely, between frames. A keyframe cannot pass its neighbours.
  • Selected keyframes move together. A small readout shows how far they moved and the new time. With several keyframes, it also shows how many.
  • The keyframe keys (←, →, ⌫ / Backspace) work wherever the pointer is, with three exceptions for the arrows:
    • If the keyframes are on x or y of the layer selected on the canvas, and the pointer is over the canvas, the arrows move their values instead (Nudge with the arrow keys).
    • If no node is selected, and the pointer is over the canvas or the node graph, the arrows step one frame (Step one frame). Point at the timeline to move the keyframes.
    • With the pointer over a clock dial, the arrows step one frame.
  • A lane always keeps one keyframe (a track keeps its last keyframe). If you delete a gate's last keyframe, the gate is removed.
  • Right-click a keyframe for ease ▸, edit curve… and delete keyframe. Double-click it, or choose edit curve…, to open its curve in the curves view.
  • Right-click an empty part of a lane for key here, select all keys in the lane and delete selected keys.
  • Point at a keyframe to see its phase and its value. A gradient colour keyframe is filled with its colour.
  • The lanes show keyframes in scene time. A clock shorter than the loop shows each keyframe at every repeat. Drag any repeat, and all of them move.
  • Faint ticks on a lane show where each repeat of its clock starts.
  • A lane that reads · per frame holds per-frame samples: one keyframe on every frame, from tracking data or baked motion. Claude writes them this way, and the scene file stays small. To make a layer follow something in a video, use Import tracking data (After Effects, Mocha, a CSV or JSON file), or ask Claude: it can also track a rectangle in the clip itself. Change values and delete keyframes as usual: the lane stays samples. A new ease, or a keyframe moved off its frame, makes the lane ordinary keyframes when you save. The previous / next keyframe jumps and the layer's bar mark only the first and the last sample.
  • You cannot add, move or delete keyframes on a locked layer (layer locked).

Copy keyframes to another property

Copy all keyframes of one property and paste them onto another property.

  1. In Properties, right-click the animated row and choose copy animation.
  2. Right-click the other row and choose paste animation.
  • The paste replaces the keyframes the other row had. A row with no animation starts one.
  • When you copy a layer, its animation comes with it.

Trim a layer

Change when a layer starts and ends on screen: its in point and out point.

  1. Point at the thin handle at the left or right end of the layer's bar, in the top half of the bar. A small tag says trim.
  2. Drag the end left or right. A readout shows the new time and length.
  3. Release.

Or use keys. Move the playhead to where the layer should start or end. With the pointer over the layers view, press ⌥[ / Alt+[ (in point) or ⌥] / Alt+] (out point). These are the After Effects trim keys.

  • ⌥[ and ⌥] act on the selected layers, or else on the layer under the pointer. If there is none, the hint says select a layer to set its in point (or out point).
  • The out point keeps the frame under the playhead.
  • A trim lands on whole frames or on a nearby target (snapping). Hold ⌘ (Mac) / Ctrl (Windows) to turn the targets off (or on). Hold ⌥ / Alt to place it freely.
  • A trim never moves the keyframes. They stay at their times.
  • To give the layer the whole loop again, double-click its bar, or right-click it and choose reset in / out.
  • The YAML saves the in and out points as the layer's span, for example span: [1s, 3s].
  • A bar cannot cross the end of the loop. For that, use two layers or a gate.
  • On a video, a trim deletes only the layer markers it cuts off. The readout counts them, for example 1 marker cut.
  • An audio layer has no bar, so you cannot trim it here.
  • The bare i and o do not trim a layer. They set the work area, from anywhere (Loop a part of the scene).

Slip a video clip

Choose which frames of a video play, without moving the layer. This is called a slip.

  1. Point at the left or right end of the video's bar, in the bottom half of the bar. A small tag says slip.
  2. Drag left or right. The clip slides under the bar.
  3. Release when the frames you want are inside the bar.
  • While you drag, the whole clip shows dimmed behind the bar. A tag at each end shows how much clip is left. The tags turn red where the clip ends.
  • The canvas shows the frame at the end that you hold. When you release, the playhead goes back to where it was.
  • A slip moves in whole frames. Hold ⌥ / Alt to slip freely. A slip does not snap to targets.
  • A slip changes the clip's offset:, that is, where the clip starts on the transport.
  • Every layer that plays the same video file moves with the slip. The hint tells you when this happens, for example one clip, 3 layers: the slip moves them all.
  • To start the clip exactly on the layer's in point, right-click the bar and choose start the clip at the in point.
  • On a layer that is not a video, the bottom half of an end trims.

Move a layer in time

Move a layer earlier or later, and keep its length. Its keyframes move with it, as in After Effects.

  1. Point at the middle of the bar, in the bottom half of the bar. A small tag says move.
  2. Drag left or right.
  3. Release.

Or nudge (move a little) with keys. Select the layers, and put the pointer over the layers view. Press ⌥← / Alt+← or ⌥→ / Alt+→ to move them one frame. Add ⇧ / Shift for 10 frames.

  • The keyframes, the effects' keys and the layers inside move with the bar. The layer's delay changes by the same amount (Delay a layer).
  • To move only the in and out points, and leave the keys where they are, use Move In/Out Only (the steps below). For the nudge keys, add ⌘ / Ctrl: ⌥⌘← / Alt+Ctrl+←.
  • A layer that fills the whole loop moves too. Its bar stays, and its keys turn around the loop: a key pushed past the end comes in again at the start. The readout shows the new delay, for example +12f · delay +0.40s.
  • Selected layers move together. Layers with an in and out point stay inside the loop.
  • A video's frames move with the bar when no other layer plays the same file. If another layer plays it too, the frames stay, and the hint says the clip stays: another layer plays it too.
  • A move lands on whole frames, or with one end on a nearby target (snapping). Hold ⌘ (Mac) / Ctrl (Windows) to turn the targets off (or on).
  • A readout shows how far the layer moved, its new in point and its length.
  • A trim never moves the keys: only a move does. To choose other frames of a video without moving the bar, slip the clip.
  • Moving one layer never pushes another layer later or earlier.
  • Hold ⌥ / Alt, or press c, during the drag to make a copy instead (Copy a layer by dragging).
  • ⌥ / Alt also places the move freely, between frames.
  • Audio layers and locked layers do not move.

Move In/Out Only: move a trimmed layer's in and out points, and leave its keyframes where they are.

  1. Right-click the layer's bar and choose Move In/Out Only.
  2. The bar gets a dashed outline, and its ends light up. The tag says move in / out only.
  3. Drag the bar (anywhere on it, its ends too) left or right. The readout ends with keys stay.
  4. Release. The mode ends after this one drag.
  • To cancel the mode before you drag, press Esc, or click somewhere else.
  • The layer's delay does not change, because the keyframes do not move.
  • A layer on the whole loop has no in and out points, so the menu item is grey. Trim the layer first.
  • In older versions, ⌘ (Mac) / Ctrl (Windows) during the drag did this. Now that key only turns snapping on or off (Snap with ⌘ / Ctrl).
Every drag is one undo step

Press Esc during a drag to cancel it. The layer goes back to where it was. Esc cancels only the drag: the timeline stays open, and the selection stays as it is.

Copy a layer by dragging

Make a copy of a layer at a new time.

  1. Point at the middle of the bar, in the top half of the bar. A small tag says + copy.
  2. Drag left or right. A faint copy of the bar, with a +, follows the pointer.
  3. Release. The copy appears at the new time, and the original stays.

The copy's keyframes move with it. So you can build one line, copy it a little later, and get a real stagger. This works for a layer on the whole loop too. To keep the copy's keyframes at the original times, duplicate the layer (d), then use Move In/Out Only on the copy (Move a layer in time).

  • To switch between copy and move during the drag, hold ⌥ / Alt or press c.
  • To copy without snapping, hold ⌘ (Mac) / Ctrl (Windows) during the drag (Snap with ⌘ / Ctrl). ⌥ / Alt also places the copy freely, between frames.
  • Selected layers are copied together.
  • If you release at the same time as the original, no copy is made.
  • To copy and paste with keys, see Duplicate, copy and paste layers.

Split a layer

Cut a layer in two at the playhead.

  1. Select the layer.
  2. Move the playhead to where you want the cut.
  3. With the pointer over the layers view, press s. Or right-click the bar and choose split at playhead.
  • The first part ends at the playhead. A copy right in front of it plays the rest, so the picture does not change. Both parts keep their keys at the same times.
  • The playhead must be inside the layer. If not, the hint says the playhead is not inside the layer.
  • With no layer selected, s splits the layer under the pointer.
  • Several selected layers split together, in one undo step. Audio layers do not split.
  • A video's layer markers go to the part they show in.
  • With the pointer away from the timeline, s opens the scene list.

Duplicate, copy and paste layers

Make copies of layers with keys or with the right-click menu.

  1. Select the layers.
  2. With the pointer over the layers view, press d or ⌘D / Ctrl+D to duplicate them in place.
  3. Or press ⌘C / Ctrl+C to copy them. Move the playhead, then press ⌘V / Ctrl+V to paste them.
  • A duplicate has the same timing and sits right in front of the original. It does not move on the canvas.
  • With no layer selected, these keys act on the layer under the pointer.
  • A paste goes in front of all layers of the surface or comp. Its earliest in point lands on the playhead, and its keyframes move with it.
  • To paste at another time, right-click the ruler, an empty part of the tracks, or a bar, and choose paste here. The paste lands where you right-clicked.
  • You can paste only into the scene that you copied from. In another scene, the hint says those layers are from and the scene's name.
  • With nothing copied, the hint says nothing copied — ⌘c over a layer first.
  • The copies become the selection. Copies keep their clocks, effects, markers and colour.
  • Locked layers are not duplicated or split.

Delay a layer (time offset)

A delay makes a layer, and everything inside it, run later. Its keyframes, its effects and the layers inside it all wait. Use it to stagger copies, or to send one comp around the surfaces one after another (a chase).

  1. Move the layer's bar in the timeline (Move a layer in time). The delay changes by the same amount. (Move In/Out Only does not change the delay: it moves only the in and out points.)
  2. Or select the layer, and type the delay in seconds in Properties. Click ⋯ in the top strip if the row is hidden.
  3. For a whole surface, select the surface and type its delay (A surface's sheet). It delays the comp on that surface only.
  • A bar with a delay shows it as a small tag, for example +0.40s.
  • A negative delay runs the layer earlier.
  • The delay wraps around the loop. A layer delayed by 1 s plays its last second at the start of the loop, so the loop never jumps.
  • A delay does not move the layer's own in and out points. A move in the timeline writes both.
  • On a use: layer, the delay moves the whole comp, its in and out points too. So several copies of one comp, each a little later, chase each other.
  • Inside a comp, the timeline shows the comp's own time. Each copy and each surface adds its own delay.
  • A video plays one time per file, so its frames do not follow a delay. Band drivers follow the music, not the delay.
  • The YAML saves it as delay: 400ms (Common props). A scene that holds one is saved as schemaVersion: 7.

Delete a layer

Remove layers from the surface or comp.

  1. Select the layers.
  2. Press ⌫ / Backspace or Delete. Or right-click a bar and choose delete.
  • When keyframes are selected, these keys delete the keyframes instead. Press Esc first to clear them.
  • The delete is one undo step.

Snap to edges, markers and keyframes

When you drag close to an important time, the drag lands exactly on it.

  1. Drag a bar, the end of a bar, a keyframe, a marker or the work area.
  2. Come within 8 px of a target. A thin line shows what it caught.
  3. Release.
  • The targets are the start and end of the loop, the playhead, and other layers' in and out points. Markers, keyframes on other open lanes, beats and the edges of the work area are targets too.
  • Beats come from an audio beat clock (The musical map). They show as faint ticks. They are targets only when they are at least 4 px apart.
  • Away from a target, a drag still lands on whole frames.
  • Hold ⌘ (Mac) / Ctrl (Windows) while you drag to change the targets: they are off when snapping is on, and on when it is off. Whole frames still apply. This is the same key as on the canvas (Snap with ⌘ / Ctrl).
  • Hold ⌥ / Alt while you drag to place it freely: no targets and no whole frames.
  • To turn the targets off, click snap in the header. Or press n with the pointer over the layers view, or right-click the ruler and choose snapping off.
  • The snap button is highlighted while snapping is on. The hint says snapping off — frames only (n) or snapping on (n).
  • With the targets off, drags still land on frames. Starlight remembers the choice for each project.
  • A slip, a scrub of the ruler and a drag in the curves view land on frames only. They never snap to targets.

Add timeline markers

A marker is a named, coloured moment for you, for example the downbeat or the logo hit.

  1. Move the playhead to the moment.
  2. With the pointer over the layers view, press \. Or double-click the ruler at that time, or right-click the ruler and choose add marker here.
  3. To name the marker, double-click its flag, type the name and press ⏎ / Enter.
  • A flag shows the marker's name, or its time if it has no name.
  • A marker lands on a frame, or on a nearby target. Hold ⌥ / Alt when you double-click the ruler to place it between frames.
  • Drag a flag to move it. Click a flag to move the playhead there. Press Esc during the drag to cancel it.
  • In the name field, ⏎ / Enter or a click elsewhere keeps the name. Esc cancels. An empty name removes the name.
  • Right-click a flag for its colour, label…, move to playhead and remove marker. move to playhead is grey when the marker is already there.
  • Click ⚑ n in the header for a list of all markers. Click one to go there, or click × to remove it. A click outside the list closes it.
  • Only one marker can sit on a frame. A second one shows the hint a marker is already here.
  • Markers are saved with the scene, and you can undo them. They are never rendered or exported, and they do not start anything.
  • A cue is different: a trigger can start a clock from a cue (Cues).
  • The curves view shows markers too, but you cannot edit them there.
  • In the YAML, markers are the scene's markers: list.

Mark a frame in a video

A layer marker marks a frame inside a video clip, and it moves with the clip.

  1. Select one or more video layers.
  2. Move the playhead to the frame.
  3. With the pointer over the layers view, press ⇧\ / Shift+\. Or right-click the bar and choose add layer marker here.
  • With no layer selected, ⇧\ / Shift+\ marks the video under the pointer. If there is no video to mark, the hint says select a video layer to mark its clip.
  • Marking several videos is one undo step.
  • The right-click item adds the marker where you right-clicked, not at the playhead.
  • Layer markers show as small notches on the bar.
  • They stay on their frame of the clip. A slip moves them, but moving or trimming the bar does not.
  • Drag a notch along the clip to move it. Click it to move the playhead there. Double-click it to name it, and right-click it for its menu.
  • Only one layer marker can sit on a frame of the clip (a marker is already on this frame).
  • A trim deletes only the markers it cuts off. A split gives each part the markers that show in it.
  • In the YAML, they are the markers: list on the video.

Loop a part of the scene (work area)

The work area is a part of the loop that plays again and again while you work on it. You can set it from anywhere in the app, with the timeline open or closed.

  1. Move the playhead to where the part starts. Press i (in).
  2. Move the playhead to where the part ends. Press o (out).
  3. Press Space to play. Only the work area plays, again and again.
  4. To play the whole scene again, click × on the loop chip at the bottom left of the canvas.
  • i and o work over the canvas, the node graph, the timeline and the panels. They do nothing while you type in a field, in the Claude panel's terminal, or in a dialog.
  • While a work area is set, a chip shows it next to the time at the bottom left of the canvas, for example loop 1.00–2.00 s ×. When the time shows frames, the chip shows frames too, for example loop 30–60 f.
  • The work area plays when the timeline is open and when it is closed.
  • o keeps the frame under the playhead inside the work area.
  • If you press only i, the work area runs to the end of the loop. If you press only o, it begins at the start of the loop.
  • If the playhead is outside the work area when you play, it jumps to the start of the work area.
  • With the pointer over the timeline's layers view, [ and ] do the same as i and o. The hint then shows the new work area, for example work area 1.00s – 2.00s · playback loops it.
  • You can also right-click the ruler and choose work area in here or work area out here.
  • In the timeline, the work area is a band at the bottom of the ruler. Drag its edges or its middle to change it. The drag snaps like other drags, and Esc cancels it. The rows outside the work area are shaded.
  • To remove it, click × on the chip. Or double-click the band, or right-click the ruler and choose clear work area. A work area that covers the whole loop is removed too.
  • The scene dial's right-click menu has a work area button too (Use the clock dials).
  • Each scene remembers its work area. It is not saved in the scene file. Export and Glimpse never use it: they always use the whole loop.
  • To trim a layer at the playhead, press ⌥[ / Alt+[ or ⌥] / Alt+] over the layers view (Trim a layer).
  • To go to the previous or next scene, press ⌘PageUp / Ctrl+PageUp or ⌘PageDown / Ctrl+PageDown.

Change the row height

Make the rows taller to see filmstrips and waveforms better.

  1. Click rows in the header.
  2. Click it again for the next height. The heights are 22, 32 and 44 px, and then 22 again.
  • The button is highlighted when the rows are taller than 22 px. Its tooltip says the height now and the next one.
  • Starlight remembers the height for each project.

See video frames and audio waveforms

Video bars show small pictures of their frames, and audio rows show the shape of the sound.

  • A video bar shows a filmstrip. Each small picture is the frame that the clip plays at that time. A slip moves the pictures live.
  • An audio row shows its waveform (how loud the sound is) where it plays.
  • Starlight makes them in the background, from the clip's proxy (a smaller copy of the video) when it has one, and from the audio analysis. Playback never waits for them.
  • Taller rows show them better (Change the row height).

Edit in the curves view

The curves view shows the curves of one animated layer over one cycle of its clock. You see and edit its keyframes, their values and their eases there.

  1. Select an animated layer.
  2. Click the curve icon at the left of the panel's header, or press ⌥T / Alt+T.
  3. Click a keyframe (◆) to select it.
  4. Drag it. Left and right change its time. Up and down change its value.
  5. To shape the curve, drag one of its handles (Shape a curve with handles).
  6. To set an ease, click an ease button in the header (Set an ease).
  • The view always shows the selected layer. Select another animated layer to see its curves.
  • For a ✥ row, the view shows the transform's curves. If the transform has no animation, it shows the curves of the content (for example the image or the text).
  • The width of the view is one cycle of the layer's clock. A 2-second clock fills the panel, whatever the loop length.
  • There is one lane for each animated property: the transform properties, the gradient settings and the effect settings (for example glow · intensity). Each lane shows its curve, its keyframes and its values (Read the curves view).
  • Double-click an empty part of a lane's graph to add a keyframe. It takes the value the curve has there.
  • ← and → nudge the selected keyframes by 1% of the cycle. With ⇧ / Shift they nudge them by 5%.
  • ⌫ / Backspace or Delete deletes the selected keyframes. A lane keeps its last keyframe.
  • These keys work wherever the pointer is. Esc closes the panel. During a drag, Esc cancels the drag first.
  • Right-click a keyframe for ease ▸ and delete keyframe.
  • The gate row comes first, if the layer has a gate. It shows when the layer is on, as bars. Drag an edge or the middle of a bar. Double-click empty space to add one. Right-click one and choose Delete Gate Span.
  • Cues show as named lines. Right-click a cue to remove it at once.
  • Timeline markers show here too, but you cannot edit them here.
  • Drag the ruler to move the playhead within the cycle.
  • Drag the bottom edge of any lane to make all lanes taller or shorter. Drag the top edge of the panel to make the whole panel taller or shorter.
  • Keyframes on a locked layer do not move. The hint says layer locked.
  • In and out points, markers and lane values are in the layers view.
  • Everything you can do here, step by step: Curves and eases. The keys: Curves view.

Right-click menus

Right-click a part of the timeline for its menu.

WhereMenu items
A layer barThe layer's name (or 3 layers) at the top · duplicate · split at playhead · copy · paste here · colour · add marker here (on a video: add layer marker here) · start the clip at the in point (a video) · reset in / out (a trimmed layer) · Move In/Out Only (a trimmed layer: the next drag moves only the in and out points) · reveal in graph · select all after the playhead · select all before the playhead · delete
A keyframeease ▸ · edit curve… · delete keyframe. A gate keyframe has only delete keyframe.
An empty part of a lanekey here · select all keys in the lane · delete selected keys
A marker or a layer markercolour · label… · move to playhead · remove marker
The ruler, or an empty part of the tracksadd marker here · paste here · work area in here · work area out here · clear work area · select all after here · select all before here · snapping on or snapping off
The curves viewA keyframe: ease ▸ · delete keyframe. A gate bar: Delete Gate Span.
  • With several layers selected, the bar menu acts on all of them.
  • Here means the time where you right-clicked. At playhead means the playhead.
  • The menus show each item's key or gesture at the right, for example s or double-click. Grey items cannot be used now, for example on a locked layer.
  • In ease ▸, a dot (●) marks the keyframe's ease now. delete keyframe is grey on a lane's last keyframe.
  • The colour is the same colour as the node in the graph. It tints the bar.
  • All menus of the app: Right-click menus.

From a property row

Right-click a row in Properties to reach the timeline from there. All items: Right-click a property.

  • Its timeline items are reveal in timeline, animate this property, add key at playhead and remove key at playhead.
  • It also has ease ▸, edit curve…, copy animation and paste animation.
  • ease ▸ and edit curve… show only when a keyframe is at the playhead.
  • edit curve… opens the curves view on that lane, with the keyframe at the playhead selected.

Read the hint

The hint in the middle of the header says what an action did, or why it did nothing. It goes away after a few seconds.

HintWhat it means
layer lockedThe layer, or a layer around it, is locked. Click its ⊘ to unlock it.
a track keeps its last keyframeA lane always keeps one keyframe. You cannot delete the last one.
can't drop thereThe layer cannot go to that place in the stack.
a layer on the whole loop has no in / out to move — trim it firstMove In/Out Only moves only the in and out points, and this layer has none. Trim it first, or move it with its keys.
Move In/Out Only: drag the bar · the keys stay · Esc cancelsThe mode is on for this bar. Its next drag moves only the in and out points.
Move In/Out Only: cancelledYou pressed Esc before the drag. The bar's next drag moves its keys again.
the clip stays: another layer plays it tooThe keys move, but the video's frames stay: another layer plays the same file, and a file plays at one time.
the playhead is not inside the layerA split needs the playhead inside the bar.
select a layer to …The key needs a selected layer, or a layer under the pointer.
select a layer with an in / out to nudge its window⌥⌘← / Alt+Ctrl+← moves only in and out points, so it needs a trimmed layer.
select a video layer to mark its clip⇧\ / Shift+\ needs a video layer.
a marker is already hereOnly one marker can sit on a frame.
nothing copied — ⌘c over a layer firstCopy layers before you paste.
those layers are from …You can paste layers only into the scene you copied them from.
at the first edit point, at the last edit point↑ or ↓ has no edit point further in that direction.
no earlier keyframe, no later keyframe‹ or ›, or j or k, has no keyframe further in that direction.
no keyframesj or k found no keyframe in the scene (Go to the previous or next keyframe).
a gate holds — no easeA gate is only on or off. It has no curve to edit.
  • Right-click menus write the keys for your computer: ⌘C on a Mac is Ctrl+C on Windows. A hint line in the timeline header can still show ⌘; on Windows it means Ctrl.

Timeline keys

All timeline keys are in Keyboard & mouse: keys, mouse, keyframes, the curves view and its tools.

  • These keys act on the timeline only with the pointer over its layers view: ⌥[ ⌥] s d n [ ] \ 0 + - and the arrow keys.
  • ⌥[ and ⌥] are the After Effects trim keys: they set a layer's in and out point.
  • [ and ] set the work area here, as i and o do anywhere. Away from the timeline, [ and ] do nothing: they never switch scenes.
  • The same is true for ⌘C / Ctrl+C, ⌘V / Ctrl+V and ⌘D / Ctrl+D.
  • One exception: with keyframes selected, ←, → and ⌫ / Backspace act on them wherever the pointer is.

On this page