Transport and playback
The transport is the row at the bottom left of the canvas. It plays and pauses the scene, and it shows the current time.
Read the transport row
The transport row is one line of text at the bottom left of the canvas.
| Part | What it shows |
|---|---|
| ▶ or ⏸ | The button shows what a click does, as in other video apps. ▶ (play) shows while the scene is paused. ⏸ (pause) shows while it plays. Its tooltip says the same: play (space) or pause (space). |
1.49s / 4.00s | The time of the playhead, and the length of the loop. Click it once to switch to frames (Show seconds or frames). Double-click it to go to the first frame (Go to the first or last frame). Scroll over it to move one frame at a time (Scrub to a time). |
28 fps in red | You see fewer frames each second than the scene's fps: frames are dropped. It shows only while the scene plays. With the FPS HUD on, the HUD shows this number instead (The red frame rate). |
30 / 30 fps | The FPS HUD, when it is on: the frames you really see each second, out of the scene's fps. When frames are dropped, it is red and says what is slow, for example 10 / 30 fps · north.mp4 can't play this fast (See how fast the canvas draws). |
loop 1.00–2.00 s × | The work area, when one is set: only this part plays. Click × to clear it (Loop a part of the scene). |
| paused · space to play | A short hint when a moving scene opens paused (The paused hint). |
- The playhead is the current time in the scene. Everything on the canvas shows that moment.
- When you play or pause, only the button changes. The time and the rest of the row do not move. The time also keeps its place when its number gets more digits.
- A thin yellow bar along the bottom edge of the window shows how far the playhead is through the loop. It hides while the timeline is open, because the timeline has its own playhead.
- Right-click ▶ or the time for the transport buttons (Use the clock dials).
Play and pause
Start or stop playback of the scene.
- Press Space.
- Or click the button at the left of the transport row: ▶ when the scene is paused, ⏸ when it plays.
- Or click the centre of the scene clock's dial in the node graph (Use the clock dials).
- The scene plays when a project opens. When you open another scene, playback stays as it was: playing or paused.
- The scene always loops: after the last frame, the first frame plays again.
- Playback moves frame by frame, at the scene's fps (Set the frame rate). The canvas shows a new picture only when the next frame starts, so you see the same frames as in an export.
- When you pause, the canvas stays on the frame that you see.
- A red number such as
28 fpsbeside the time means that you see fewer frames than the scene has. The canvas or a video drops frames (The red frame rate). - A work area is a marked part of the loop. Set it with i and o. While it is set, playback repeats only the work area, with the timeline open or closed (Loop a part of the scene).
- If the playhead is outside the work area when you play, it jumps to the start of the work area.
- Space does nothing while you type in a field. In the Claude panel's terminal, all keys go to the terminal.
- While you draw with the pen or edit a path's points, Space does not play.
Scrub to a time
To scrub is to drag through time to find a moment. Playback pauses while you scrub.
- Open the timeline with ⇧T / Shift+T.
- Drag in the ruler at the top of the tracks.
- Release at the moment you want.
- The playhead lands on whole frames.
- You can also drag sideways on a clock dial's ring in the node graph. Hold ⇧ / Shift to scrub 4 times slower (Use the clock dials).
- Video and audio follow the playhead while you scrub.
Scroll over a clock. You can also scrub with the mouse wheel or with two fingers on a trackpad.
- Put the pointer over a clock. A clock is any of these: ▶ or the time in the transport row, the time in the timeline's header, or a dial in the node graph (the scene clock, a named clock, an audio dial or a video dial).
- Scroll down (towards you) to go forward. Scroll up to go back.
- One click of a mouse wheel moves one frame.
- On a trackpad, a short swipe moves a few frames. The playhead moves at most one frame for each small movement, so it never jumps.
- Hold ⇧ / Shift to move 10 frames at a time.
- Scrolling pauses playback, as a drag does. It goes around the loop: from the last frame, forward goes to the first frame.
- Every clock, the canvas, the video and the audio go to the same frame.
- Scrolling anywhere else does what it did before. Over the canvas and the graph it zooms, and over a panel it scrolls the panel.
- A scroll that starts away from a clock keeps doing what it started. For example, a zoom of the graph does not change into a scrub when a dial comes under the pointer. Stop for a moment, then scroll again over the dial.
- A pinch on a trackpad, or ⌘ / Ctrl with the wheel, still zooms the graph, also over a dial.
Step one frame
Move the playhead forward or back by exactly one frame.
- Press . to go one frame forward.
- Press , to go one frame back.
- Hold ⇧ / Shift with these keys to step 10 frames.
- A step pauses playback.
- Steps go around the loop: one step back from the first frame goes to the last frame.
- , and . always step, whatever is selected.
- ← and → also step (⇧ / Shift for 10 frames) when nothing is selected.
- With no node selected and the pointer over the canvas or the node graph, ← and → always step. They step also when keyframes are selected in the timeline.
- With the pointer over a clock dial, ← and → always step, whatever is selected. Keyframes selected in the timeline (in either view) stay where they are. Over the timeline's layers view, the arrows step when no keyframes are selected there.
- With a layer selected and the pointer over the canvas, the arrow keys move the layer instead (Nudge). With the pointer elsewhere and a node selected, they move the selection through the node graph.
- With keyframes selected in the timeline, ← and → move those keyframes one frame. This is not so over a clock dial, or over the canvas or the node graph with no node selected: there they step.
- j and k do not step frames. They go to the previous or next keyframe (Go to the previous or next keyframe).
- The ‹ and › buttons beside the scene dial's centre step a frame too. Hold ⇧ / Shift for 10 frames, and hold the button to repeat.
Go to the first or last frame
Jump straight to the start or the end of the loop.
- Press Home to go to the first frame of the loop.
- Press End to go to the last frame of the loop.
- Press ⇧F / Shift+F to go to the first frame and keep the play state. If the scene plays, it plays on from the first frame. If it is paused, it stays paused.
- Or double-click the time in the transport row, or the time in the timeline's header. This is the same as ⇧F / Shift+F: the play state does not change.
- These are the first and last frames that an export renders.
- Audio and video go to the same place. Home starts a song again from its beginning.
- Home and End pause playback. ⇧F / Shift+F and a double-click on the time do not.
- A double-click on the time does not switch between seconds and frames. Only a single click does that (Show seconds or frames).
- With a work area set, ⇧F / Shift+F during playback plays from the start of the work area (Loop a part of the scene).
- A Mac laptop has no Home or End key. Press Fn+← or Fn+→ instead.
- In the timeline, ↑ and ↓ jump to the previous or next edit point (Move the playhead in the timeline).
Go to the previous or next keyframe
Jump the playhead from one keyframe to the next, as in After Effects.
- Press k to go to the next keyframe.
- Press j to go to the previous keyframe.
- With a layer selected, j and k go to the keyframes of that layer: its animated properties, its gradient and its effects. If the selected layer has no keyframes, they go to every keyframe in the scene.
- With nothing selected, they go to every keyframe in the scene.
- A layer's clock can be shorter than the scene. Then its keyframes come again each time the clock repeats, and j and k stop at each one.
- The playhead lands on whole frames. Keyframes in the same frame count as one.
- A jump pauses playback.
- The keys do not go around the loop. At the last keyframe, k stays there and the hint says no later keyframe. At the first keyframe, j says no earlier keyframe.
- If there are no keyframes, nothing moves and the hint says no keyframes.
- The keys work with the pointer anywhere, also when the timeline is closed. They do nothing while you type in a field.
- The command palette has the same commands:
previous keyframeandnext keyframe. The scene dial's transport buttons have them too (Use the clock dials).
Set the scene length (the loop)
Every scene is a loop with a fixed length. The default length is 4 seconds.
- In the node graph, click the ring of the large dial at the far right, or its name
scene. This is the scene clock. A click in the centre only plays or pauses. - In Properties, find the scene clock section.
- In the duration row, type the length in seconds (s) or in frames (f).
- The s and f fields are two ways to write the same length.
- Playback and the loop bar follow the new length at once.
- In the YAML, the length is the scene's
loop:, for exampleloop: 8s. - Each clock in the scene should fit a whole number of times into the loop. If one does not, its dial turns amber (The period rule).
- The note under fps says all clocks divide the loop, or names the clocks that make a seam at export.
- An export renders exactly one loop, so its end joins its start without a jump.
Show seconds or frames
Choose if times read in seconds or in frames, everywhere in the app.
- Click the time in the transport row. Or click the time in the centre of a clock dial in the node graph.
- Click it again to switch back.
- In the transport row, the time switches a moment after your click (a quarter of a second). Starlight waits to see if a second click comes.
- One click switches between seconds and frames. A double-click goes to the first frame, and the units do not change (Go to the first or last frame).
- Two slow clicks are two single clicks: the time switches, then switches back.
- The choice applies to the whole app: the transport, the timeline and its curves view, the dials and the lengths in Properties.
- In seconds the transport reads
1.49s / 4.00s: the playhead time and the loop length. - In frames it reads
45 / 120: frame 45 of a loop that has 120 frames. The first frame is frame 0. - Starlight remembers your choice with the project's layout.
Set the frame rate (fps)
The scene's fps (frames per second) sets the frames you step through and the frames an export renders.
- In the node graph, click the ring of the scene clock (the large dial at the far right), or its name
scene. - In Properties, in the scene clock section, type a whole number in fps.
- The default is 30. Use 60 for fast motion. The highest is 240. If you type a bigger number, the field sets 240.
- A new fps keeps the loop's length in seconds. The number of frames changes.
- A loop has length × fps frames, rounded to a whole number. For example, 4 seconds at 30 fps is 120 frames.
- In the YAML, the frame rate is the scene's
fps:. - Playback on the canvas uses this fps too. The FPS HUD shows how many of these frames your computer really shows each second (See how fast the canvas draws).
See how fast the canvas draws (FPS HUD)
The FPS HUD shows how many frames you really see each second, and what is slow when frames are dropped.
- Press ⇧I / Shift+I, or choose View › Frame Rate (⇧I). The item has a ✓ while the HUD shows. In the command palette, it is toggle fps hud.
- Read it in the transport row, right after the time, for example
30 / 30 fps. - Press ⇧I / Shift+I again to hide it.
- 30 / 30 fps: the first number is the frames you really saw in the last second. The second number is the scene's fps. When the two numbers are the same, the preview plays every frame.
- It is the same number as the red frame rate. It counts the canvas and every video on it (The red frame rate).
- When frames are dropped, the line is red and says what is slow. For example,
10 / 30 fps · north.mp4 can't play this fastmeans that the video north.mp4 shows only 10 new frames each second.the canvas can't draw this fastmeans that the surfaces are too heavy to draw. Point at the line to see more. - For the first second after you press play, it reads
… / 30 fps. While playback is paused, it readspaused. - An export never drops a frame (When your computer cannot keep up).
- audio resynced shows in amber for 2 seconds after Starlight moves the sound back to the picture. This happens, for example, when the computer's sound output stopped for a moment.
- For more detail, ask Claude for
playback_stats. It plays the scene for a few seconds. It says which surfaces are on screen and how sharp each one draws, and how many videos play their full-size file, their proxy, or are paused. For each video, it also says how often the video had to wait for its next frame, and what the video was doing at that moment. - The HUD is off each time the app starts.
- The HUD is in the transport row because no panel ever covers that line. On a narrow canvas, the end of the line is cut off with "…".
- The bare i does not show the HUD. It sets the start of the work area (Loop a part of the scene).
- For a heavy scene, see Heavy scenes.
The red frame rate
While the scene plays, a red number such as 28 fps can show beside the time, at the bottom left of the canvas. It means that you see fewer frames each second than the scene's fps. The canvas or a video drops frames.
- It shows only while the scene plays. At full speed (for example 30 frames each second in a 30 fps scene), nothing shows.
- With the FPS HUD on, the HUD shows this number instead, in red, and says what is slow. For example:
10 / 30 fps · north.mp4 can't play this fast(See how fast the canvas draws). - The number is the frames that you really see each second. Starlight takes the lower of two numbers: the frames that the canvas draws, and the frames of the slowest video on the canvas.
- A video is measured against its own frame rate. For example, a 24 fps video that shows only 18 frames each second, in a 30 fps scene, reads
23 fps: 18 ÷ 24 × 30 = 22.5. - The number is rounded to the nearest whole number. A half rounds up, so 22.5 reads 23.
- It shows after 2 seconds below the scene's fps. It goes after 2 seconds at full speed. So a short drop does not make it flicker.
- Point at it to see more. For example, canvas 30 fps · slowest clip north.mp4 18 of 24 frames means that the canvas draws every frame, but the video north.mp4 shows only 18 of its 24 frames each second. When only the canvas is slow, it reads, for example, canvas 26 fps.
- It does not show while you pause, or while an export runs. An export never drops a frame.
- When a heavy effect is on screen, the hover names it on one more line, for example: heavy effect on screen: heat-haze on hero (about 21 ms of each 33.3 ms frame) (Make an effect with Claude).
What to try when it shows:
- Close the Glimpse panel (⇧R / Shift+R). Also close Glimpse if it is open in a web browser on this computer. Both use the same graphics chip as the canvas (Keep it fast).
- Zoom out to room zoom (⇧1 / Shift+1). The videos then play their proxies: small copies that are much lighter to play (Video ingest and proxies).
- Check that the videos are ingested. A video that is not ingested yet plays its original file, which is often much heavier.
- To work on one surface, focus on its comp with f (Focus on one comp). The other surfaces and their videos stop.
- Close other apps that play video or use the graphics chip.
- If it still shows, the scene is too heavy for this computer to play live. Play it on a Windows PC, or export it (Heavy scenes).
When your computer cannot keep up
Playback always stays in real time, and in time with the sound. A slow computer shows fewer frames. It never plays the scene slower.
- While an audio layer plays, the sound is the clock. The picture follows the sound.
- Sometimes a frame takes too long to draw: a heavy effect, or an edit while the scene plays. Then the canvas skips the next frames. You see a jump, but the picture is still in time with the sound.
- The FPS HUD (⇧I / Shift+I) shows how many frames you really see each second (See how fast the canvas draws).
- When frames are dropped, a red number such as
28 fpsshows beside the time. With the HUD on, the HUD shows it. It counts the videos too (The red frame rate). - If the computer's sound output stops for a moment, the picture keeps going. When the sound comes back, Starlight moves it to the picture, and the HUD shows audio resynced.
- Surfaces that are outside the canvas do not draw, to save work. Their videos pause too, when no surface that you can see shows them. While the scene plays, they play on for 5 seconds first. So when you zoom in and out again quickly, the other surfaces' videos never stop. When you stay zoomed in on one surface, the other surfaces cost nothing after those 5 seconds. When a surface comes back into view after that, its videos jump to the playhead's frame. Glimpse and export always draw every surface.
- To see every frame of a heavy scene in real time, cache it first with ⇧Space / Shift+Space (RAM preview). To make playback lighter, see Heavy scenes.
The paused hint
When you open a scene that moves while playback is paused, the transport row shows paused · space to play.
- The hint tells you that the scene is not broken or empty: it is only paused.
- It shows for about 3.5 seconds, or until you play.
- A scene moves when it has keyframes, a gate, a drive, a named clock or a video.
- A scene with no animation and no video shows no hint.
Audio and video follow the playhead
Audio and video layers play in time with the transport.
- When you pause, audio pauses and each video shows the exact frame for the playhead.
- While audio plays, the sound is the clock that playback follows. A slow computer skips frames of the picture to stay with the sound (When your computer cannot keep up).
- When you scrub, step or jump, audio and video go to the new time.
- A song longer than the loop keeps playing across the loops. Home starts it again from its beginning.
- An audio layer's offset ms and loop set which part of the song plays (An audio layer's sheet).
- Which frames of a video play depends on its slip (Slip a video clip).
- Video never plays sound. Sound comes from audio layers.
- The 🔊 button at the top right sets what you hear: volume, mute and the output device. It never changes an export (The top-right buttons).
- An export renders the same frames that you see.
Clocks and the transport
Every clock takes its time from the transport. A clock is a timing source that drives keyframes (Clocks & animation).
- The scene clock is the loop itself. It is the large dial at the far right of the node graph (Use the clock dials).
- A shorter clock repeats inside the loop. For example, a 1-second clock plays 4 times in a 4-second loop.
- When you play, pause, scrub or step, every clock follows.
- A trigger can start a clock at a cue, later in the loop (Triggers).
Watch a heavy scene in real time (RAM preview)
A heavy scene can be too slow to play in real time on a laptop. To judge its timing, cache it first. This is After Effects' RAM preview. Starlight draws the work area once, frame by frame, keeps the frames in memory, and then plays them in real time with the sound.
- Set the part you want to watch with i and o (Loop a part of the scene). Without a work area, Starlight caches the whole loop.
- Press ⇧Space / Shift+Space. With a numeric keypad, 0 on the keypad does the same.
- Wait while the chip by the time says
caching 42%. The playhead walks through the frames as they are made. No sound plays yet. - When it is done, the part plays from its start, in real time and with the sound, and loops.
- The cache bar. A green line shows the cached frames: along the timeline's ruler, just above the work area band, and, with the timeline closed, just above the yellow loop bar. Bright green frames are sharp. Dark green frames are soft: they were cached at a lower resolution than the canvas shows now. They still play in real time.
- The chip beside the time says
cached 4.2 s · ½: how long the cached part plays, and its resolution when that is below full. Its × stops caching, or forgets the cached frames. - Space plays cached frames from the cache and draws the rest live, as before. A paused frame is always drawn live and sharp.
- The cache has the resolution the canvas shows. Zoom out before you cache to fit more frames in memory; zoom in for sharper frames.
- The memory it may use is set in Settings › media › RAM preview: by default a quarter of this computer's memory, 4 GB on a 16 GB Mac (Media). When the part does not fit, Starlight first caches it at a lower resolution (soft frames). If it still does not fit, it caches from the start of the part as far as it can, and says how much.
- Stop it with Esc, ⇧Space / Shift+Space again, or Space, which plays what is cached. The frames made so far stay.
- After an edit, only the surfaces that the edit changes lose their frames, and those frames go empty on the bar. They draw live until you cache again. An edit while it caches stops caching.
- While an export runs, caching waits, and goes on by itself after it. It also waits while a video that it draws is being prepared (ingested), or waits its turn to be.
- A frame that cannot be made (a video that does not load) is not cached: it stays empty on the bar and plays live. When several frames in a row cannot be made, caching stops and says so.
- Only the surfaces that you can see on the canvas are cached. Glimpse and export always draw live.
- It needs the graphics card's WebGPU path. When Starlight runs on WebGL, a notice says so, and scenes play live only.
Transport keys
The keys for playback. The full list is in Keyboard & mouse › Playback.
| Key | Does |
|---|---|
| Space | Play or pause |
| ⇧Space / Shift+Space · keypad 0 | Cache the work area, then play it in real time (RAM preview). Again stops caching |
| . · , | One frame forward · one frame back. Hold ⇧ / Shift for 10 frames. |
| ← · → | One frame back · one frame forward, when nothing is selected. With no node selected and the pointer over the canvas or the node graph, also when keyframes are selected in the timeline. Hold ⇧ / Shift for 10 frames. |
| j · k | The previous keyframe · the next keyframe: of the selected layer, or of the whole scene (Go to the previous or next keyframe) |
| Home · End | The first frame · the last frame of the loop |
| ⇧F / Shift+F | The first frame. Playback does not stop: a playing scene plays on, a paused scene stays paused |
| i · o | Set the start · the end of the work area at the playhead, from anywhere (Loop a part of the scene) |
| ⇧I / Shift+I | Show or hide the FPS HUD |
| ⇧T / Shift+T | Show or hide the timeline |
Properties
Properties is the sheet for what you selected. Use it to edit and animate values, and to add masks, blend modes and effects. Press ⇧P / Shift+P to show or hide it.
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.