Skip to Content
Starlight

Scenes

A scene is one piece of content for the whole room: every surface, playing one loop. This section shows how to find, make, rename and remove scenes.

What a scene is

A project has one or more scenes. Each scene is one file, scenes/<name>.yaml. Only one scene is open at a time.

  • A scene puts content on every surface (one LED output, such as N or STAGE). See Scenes, surfaces and layers.
  • A scene has its own length, the loop, and its own frame rate, the fps. Everything in it repeats every loop.
  • When you open a project, Starlight opens the scene you had open last.
  • Claude can also make and change scenes for you (Claude).

The scene name, at the top right.

  • The name of the open scene is at the top right of the window. On Windows it is in the title bar, on the right.
  • The name is a button. Click the scene name, or press S, to open the scene list.
  • An amber dot before the name means the scene has unsaved edits. Its tooltip says unsaved changes.
  • +2 unsaved after the name means two other scenes have unsaved edits too. Point at it to see which. File › Save All saves them all (Unsaved edits when you switch).
  • After a save, a note beside the name says when, for example saved 12s ago.
  • Right-click the name for the scene menu (Open the scene list).
  • In a shared project, a padlock chip beside the name shows who can edit the scene (Edit locks).

Open the scene list

The scene list shows every scene in the project, with a picture of the scene and its loop length.

  1. Click the scene name at the top right, or press S. Or choose Scene › Scene List, or type scene list in the command palette.
  2. Read the list. Each row starts with a small picture of the scene. Then come the name and the loop, for example 4.00s. The open scene is in a different colour, with a coloured frame around its picture. An amber dot before a name means that scene has unsaved changes.
  3. To open a scene, click its row. The list closes.
  4. To close the list, press Esc. If the search field has text, the first Esc clears the text and the second Esc closes the list. Or click the scene name again, or click outside the list. S does not close the list: the search field has the keyboard, so S types the letter s.

The picture. It shows the scene's first surface: the first surface that the scene puts content on.

  • Of the surfaces that show something in the scene, the first surface is the highest one on the canvas. When two or more are at the same height, it is the one most to the left. For example, a scene that shows content only on STAGE has a picture of STAGE.
  • Starlight makes the pictures by itself, in the background, one scene at a time: for every scene of the project, also the ones you have not opened. A picture is small: at most 640 pixels wide.
  • Starlight also makes the pictures while the show plays, but slowly: one picture every 3 seconds at most. When playback is stopped, it makes one picture every second.
  • Starlight watches the frames of the canvas. It waits while a frame is late or dropped, or while a frame uses 80 % or more of its time (for example 13.3 ms of the 16.7 ms that a frame has at 60 fps). When the frames are on time again, it goes on. When this happens while a picture is being made, Starlight stops that picture at once and makes it later. The diagnostics log says when Starlight waits.
  • Starlight never makes a picture while an export, reel, publish or pre-render runs.
  • The picture shows the scene as the viewer shows it at that moment: every video, picture, text, LUT, mask and effect. A video comes from its proxy (a smaller copy of the video). When a video has no proxy, Starlight takes the exact frame from the video file itself. It does this with the computer's processor, at low priority, one frame at a time, so the graphics card and the show are not slowed down. It can do this while the show plays. When a proxy is made later, the picture is made again.
  • A new picture comes after you change a scene: a few seconds after your last edit, after you save, and when you leave the scene.
  • Until its picture is ready, a scene shows an outline: the shape of its first surface, with a faint picture of the first image or video on that surface.
  • When a scene changes outside Starlight (Claude, another artist, a restore), or a picture or video it uses is replaced, or a surface's size changes, its old picture goes, and a new one comes.
  • A scene that shows content on no surface has no picture. The diagnostics log says why for each scene that has none.
  • The pictures stay on this computer only, in Starlight's own data folder. They are never put in the project folder, so a shared project in Dropbox does not change.

List or gallery. Two buttons at the top right of the list change how it looks. Starlight remembers your choice on this computer.

  1. Click the first button (rows) for the list: one row per scene, with a small picture.
  2. Click the second button (four boxes) for the gallery: bigger pictures in a grid, with the name under each picture. The pictures keep the shape of the surface, so a wide surface gets a wide picture. The gallery uses most of the window. In a small window it shows fewer pictures in each row.

Search. The field next to the two view buttons finds scenes by name, in the list and in the gallery. When the list opens, the cursor is already in this field: type a part of a name at once, for example drop. You do not need to click first. Small and capital letters are the same, and letters with accents are the same as letters without them: cafe finds Café. When you type two or more words, a scene must have all of them in its name. The top line of the list then says how many scenes match, for example scenes · 3 of 120. + new scene stays at the end. The search stays when you change the view. When the list closes, the search is cleared, so the next time the list shows every scene.

Keys in the list. The cursor stays in the search field while you use these keys, so you can type, select and open without the mouse. One scene is selected: it has a grey background. When the list opens, the selected scene is the open scene (yellow), in the middle of the list. When you type, the first scene that matches is selected. When you change the view, the selection goes back to the open scene (or to the first match).

KeyWhat it does
↓ / ↑Select the next or the previous scene. In the gallery: the scene in the row below or above. The cursor stays in the search field.
⏎ / EnterOpen the selected scene. If you typed nothing and selected nothing, this is the open scene, so the list just closes. On + new scene: make a new scene. When no scene matches, nothing happens.
⌥↓ / Alt+↓, ⌥↑ / Alt+↑Move the selected scene one place down or up in the scene order (Change the scene order). In the gallery, ⌥← / Alt+← and ⌥→ / Alt+→ work too.
← / →Move the cursor in the search text. In the list, ⌥← / Alt+← and ⌥→ / Alt+→ move it one word.
EscWith text in the search field: clear it, and every scene comes back. Press Esc again to close the list. With no text: close the list.
S, Space and the other keysType in the search field. They do not close the list, and Space does not play the show.
⌘F / Ctrl+FGo back to the search field, and select its text.

A scene can get the keyboard instead of the search field, for example when you press Tab. Then ↓ / ↑ (and ← / → in the gallery) select the scenes, and S closes the list, as before. Press ⌘F / Ctrl+F to go back to the search field. After you drag a scene, the cursor goes back to the search field by itself.

To change the order of the scenes, drag a row or a picture to a new place (Change the scene order).

  • The top line of the list says scenes · next ⌘PgDn · previous ⌘PgUp (Ctrl+PgDn and Ctrl+PgUp on Windows): the keys that open the next and the previous scene.
  • A row with an amber recover tag has a recovery draft that you put aside with Later. Click recover to see it on the recovery card again (Get unsaved edits back).
  • A scene with no loop length shows —.
  • The last row is + new scene, marked template. Its picture is a + (Make a new scene).
  • Right-click a row for the scene list menu: open, rename scene, duplicate scene, new scene and delete scene.
  • Right-click the scene name at the top right to get the same menu for the open scene.
  • For the open scene, open is grey and says current.
  • In a shared project, a scene that is still downloading shows as a grey row that says downloading…. You cannot click it yet. It opens when it arrives.
  • All items of the scene list menu: Menus. The Scene menu in the menu bar has New Scene, Scene List, Next Scene and Previous Scene, and the framed-comp items (Scene menu).

Switch scenes

Switching opens another scene in the canvas, the graph and the timeline.

  1. Click the scene name at the top right, or press S. The scene list opens.
  2. Click the scene you want.
Other waysWhat to do
⌘PageDown / Ctrl+PageDown and ⌘PageUp / Ctrl+PageUpOpen the next or the previous scene in the list. After the last scene, the next one is the first again. Before the first scene, the previous one is the last. These keys work while you type in a field too.
Scene menuScene › Next Scene and Scene › Previous Scene. The menu shows the same keys.
Command paletteType open: and the scene name, then press ⏎ / Enter. Or pick next scene or previous scene.
Right-click a surfaceRight-click an empty part of a surface on the canvas, then choose scene and a scene name. The open scene is grey and says current.
Ask ClaudeFor example: Open 05-outro. Claude opens it the same way as a click in the scene list (The MCP tools). It does not open a scene while you drag on the canvas.
  • [ and ] alone do not switch scenes. With the pointer over the timeline's layers view, they set the work area. Anywhere else they do nothing.
  • The new scene's name shows for a moment at the bottom of the canvas.
  • Only the open scene's videos stay loaded. When you switch, the other scene's videos close, so your graphics card keeps its memory for the scene you see. When you come back to a scene, its videos load again, smaller copies first.
  • Unsaved edits stay in the scene when you switch. They are still there, still unsaved, when you come back. See Unsaved edits when you switch.
  • Each scene keeps its own undo history. It is still there when you come back, until you quit Starlight.
  • In a shared project, switching away from a scene ends your lock on it. A scene with unsaved edits keeps its lock until you save them, or drop them.

Make a new scene

A new scene starts from a simple template that puts content on every surface.

  1. Press s to open the scene list.
  2. Click + new scene at the bottom of the list. Or right-click any scene and choose new scene.
  3. A small window opens. It asks for the scene's name. The name field already has a free name, for example untitled, and it is selected.
  4. Type the name. What you type replaces the name in the field.
  5. Press ⏎ / Enter, or click create. To cancel, press Esc.
  6. The new scene opens, and the list closes. A notice says, for example, new scene "intro".
  • You can also choose Scene › New Scene in the menu bar, or type new scene in the command palette. You do not need to open the list first.
  • The name follows the same rules as a rename: letters, digits, dots, dashes and underscores, with no spaces. Two scenes cannot have the same name, and case does not count: Intro and intro are the same name.
  • If the name is not allowed, a red line under the field says why, and create waits until you fix it.
  • The free name is untitled, then untitled2, and so on.
  • The template: a 4 second loop, a 1920×1080 design size, and one comp called main on every surface. The comp shows the scene's name in large amber letters that pulse every 2 seconds.
  • The new scene is saved at once, as a version.
  • The scene you were in keeps its unsaved edits. Save it later, or use File › Save All.
  • In a shared project, a new name never takes another artist's scene, even one that is still downloading.

Rename a scene

Renaming changes the scene's name and its file name.

  1. Right-click the scene name at the top right, or the scene's row in the scene list.
  2. Choose rename scene. A text box appears with the old name. Its grey text says rename scene — enter to confirm, esc to cancel.
  3. Type the new name and press ⏎ / Enter. To cancel, press Esc or click somewhere else.
  • A name can use letters, digits, dots, dashes and underscores. It cannot have spaces.
  • Two scenes cannot have the same name.
  • If the new name is not allowed, nothing changes. An error message at the top says why, for example could not rename 01-intro — a scene "intro" already exists. It stays until you click its ✕.
  • A change of case only, for example Intro to intro, works too.
  • The rename changes the saved file. Unsaved edits stay with the scene, under its new name, and are still unsaved.
  • The rename also changes the scene: line inside the file.
  • The rename is saved as a version.
  • In a shared project you cannot rename a scene that another artist is editing.

Duplicate a scene

Duplicating makes a copy of a scene under a new name, and opens the copy.

  1. Right-click the scene name at the top right, or the scene's row in the scene list.
  2. Choose duplicate scene. The copy opens.
  • The copy is called <name>-copy, then <name>-copy-2, and so on.
  • The copy is the scene as it is now, unsaved edits included.
  • The copy is saved at once, as a version. The original keeps its unsaved edits, still unsaved.

Import a scene from After Effects

An After Effects comp can become a new scene, with its media. You do it in two steps: export a JSON file from After Effects, then import that file in Starlight.

  1. In After Effects, open the comp and select it. Choose File › Scripts › Run Script File… and pick starlight-export.jsx, from Starlight's tools/ae-export folder.
  2. Choose where to save the JSON file. Keep it with the project's media. The script writes the file. It also makes a folder <name>-media beside the file, with a PNG for each PSD or Illustrator layer.
  3. In Starlight, open the project and choose File › Import After Effects JSON…. Pick the JSON file.
  • The new scene is named after the JSON file. Its length and fps are the comp's.
  • Starlight copies every image, video, audio file and image sequence the comp uses into the project's assets, as a drop does. Videos finish preparing in the background.
  • If you import the same comp again, files already in the assets are used again, not copied twice.
  • Starlight looks for each file where After Effects had it. If the file is not there, it looks next to the JSON file. So when you move an export to another computer, put the media next to the JSON file.
  • A video plays the part of the clip that the comp shows, from the same frame, every loop.
  • A layer's in and out points become its bar in the timeline. A layer whose eye is off comes in bypassed.
  • A precomp becomes a comp with a frame of its size, placed where the precomp layer was. It starts at the layer's start time.
  • When the import is done, a message lists anything that did not come in: a missing file, or a layer type Starlight does not import yet.

What does not come in yet: parenting, masks, effects, track mattes, expressions, text animators, shape layers, adjustment layers and motion paths. A layer that is animated in rotation or scale turns around its centre, not around its After Effects anchor point.

Delete a scene

Deleting removes the scene's file from the project.

  1. Right-click the scene name at the top right, or the scene's row in the scene list.
  2. Choose delete scene.
  3. Starlight asks Delete scene "<name>"? and says that it makes a version checkpoint. Click the red Delete Scene button, or Cancel (Questions and messages).
  • The delete is saved as a new version. To get the scene back, open the version list and restore the version just below it: the one from before the delete.
  • You cannot delete the last scene of a project. The menu item is grey and says last one.
  • If you delete the open scene, Starlight opens the project's default scene, or else the first scene in the list.
  • A deleted scene's unsaved edits are deleted too, and so is its recovery draft. Every other scene keeps its unsaved edits.
  • In a shared project you cannot delete a scene that another artist is editing.

Change the scene order

You can put the scenes in any order. The scene order is the order of the scene list. ⌘PageDown / Ctrl+PageDown and ⌘PageUp / Ctrl+PageUp, the command palette, the reel and Claude all use the same order.

Drag a scene.

  1. Press S to open the scene list. The list view and the gallery both work.
  2. Hold the mouse button down on a scene, and drag it.
  3. A yellow line shows where the scene will go. In the list it is above or below a row. In the gallery it is left or right of a picture.
  4. Release the mouse button. The scene moves there.

Use the keys.

  1. In the scene list, press ↑ or ↓ to select a scene.
  2. Press ⌥↑ / Alt+↑ to move it one place up. Press ⌥↓ / Alt+↓ to move it one place down. In the gallery, ⌥← / Alt+← and ⌥→ / Alt+→ work too.

Use the menu.

  1. Right-click a scene in the scene list, or the scene name at the top right.
  2. Choose move up or move down.
  • The new order is saved at once, in project.yaml (the sceneOrder: list). You do not need to press ⌘S. No scene file changes. Starlight also makes a version, for example moved scene 03-finale in the scene order. Moves you make quickly, one after the other, make one version.
  • ⌘Z / Ctrl+Z puts the old order back. ⇧⌘Z / Ctrl+Shift+Z does the move again.
  • You can also move scenes while a search is on (Open the scene list). A scene that you drag goes right before or after the scene you drop it on. ⌥↑ / Alt+↑ and ⌥↓ / Alt+↓ move it past the previous or the next scene that matches. Only the scene you move changes its place. The other scenes, also the ones the search hides, stay in the same order.
  • A new scene goes at the end of the list. A duplicate goes right after its scene. A renamed scene keeps its place.
  • Before you change the order for the first time, the list is in name order. Digits come before letters, and capital letters come before small letters.
  • In a shared project, every artist sees the same order. When two artists change the order at the same moment, Dropbox can keep two copies of project.yaml. Choose which one to keep (Resolve a conflicted copy).

Set the scene's length and fps

The scene's loop length and fps are on the scene clock, the large dial at the right of the node graph.

  1. Press g to show the node graph.
  2. Click the ring of the scene clock, or its name scene above it. The scene clock is the large dial at the far right. Do not click the centre of the dial: a click there only plays or pauses.
  3. Press ⇧P / Shift+P to show Properties, if it is hidden.
  4. Under scene clock, type the duration in seconds or in frames, and the fps.

What happens to the animation. By default, every keyframe keeps its time in seconds, as in After Effects. A key at 2 s stays at 2 s.

  • A longer scene: the last pose holds until the new end.
  • A shorter scene: keys after the new end are kept. They do not play, because the loop ends first. Make the scene longer again, and they come back. The note under the field counts them, for example 1 clock keeps 10.00s: 2 keys after the new end. That clock now has its own length (the old one), so its keys stay where they are.
  • In and out points, markers, delays, the work area and the start of each video and audio clip keep their times too.
  • A clock with its own period keeps it. A clock set to scene/N keeps N cycles in the scene, so its keys move with the length.
  • To make everything faster or slower instead, see Stretch the animation to a new length.
  • The two duration fields show the same length. Change either one, and the other follows.
  • Changing fps keeps the length in seconds. The frame count changes.
  • The default fps is 30. Export and frame stepping use it. See fps and frames.
  • Other clocks must fit a whole number of times into the loop. A note under the fields tells you if they do. It says no named clocks, all clocks divide the loop, or seam at export: <clock names>.
  • You can undo these changes.
  • To play and step through time, see Transport.

Stretch the animation to a new length

Make the whole animation faster or slower, so that it fits a new scene length.

  1. Select the scene clock, as in Set the scene's length and fps.
  2. Under scene clock, turn on stretch · animation to fit.
  3. Type the new duration.
  • Every time scales by the same amount: keyframes, in and out points, markers, delays, clock periods, a cloner's stagger, the work area and the start of each video and audio clip.
  • The note under the field says how much, for example animation stretched ×1.20 to 12.00s.
  • Videos and songs still play at their normal speed. Only where they start moves.
  • Beat clocks (made from a song) follow the song, so they do not stretch.
  • The choice stays on while the sheet is open. Turn it off to keep key times again.
  • You can undo the change.

Unsaved edits when you switch

Every scene keeps its unsaved edits while the project is open. You can leave a scene before you save it. Nothing is lost.

  1. Edit a scene, for example 01-intro. Do not save it.
  2. Switch to another scene. The canvas shows that scene.
  3. Press s. In the scene list, 01-intro has an amber dot: it has unsaved changes. At the top right, +1 unsaved says the same.
  4. Switch back to 01-intro. Your edits are there, still unsaved. ⌘Z / Ctrl+Z still undoes them, one by one.
  5. Save:
    • ⌘S / Ctrl+S saves the open scene.
    • File › Save All (⌥⌘S / Ctrl+Alt+S) saves every scene with unsaved changes. Each scene is saved as its own version.
  • When you leave a scene with unsaved edits, Starlight also writes a recovery draft of it at once. If Starlight crashes, the draft brings the edits back (Get unsaved edits back).
  • The recovery card never offers a draft of a scene whose edits are still open in Starlight.
  • Reload Project from Disk (⌘R / Ctrl+R) asks first. Then it keeps a recovery draft of every unsaved scene and reloads every scene from disk. The recovery card offers the drafts back.
  • Restoring a version (Save and go back) also replaces every scene. It asks first.
  • If Claude or another artist changes a scene that has unsaved edits here, your edits stay. A warning says so. When you save that scene, your version replaces theirs.
  • If another program deletes or renames a scene with unsaved edits, the edits leave the app, but they stay in that scene's recovery draft. A warning says so.
  • Before you quit, close the window or open another project, Starlight asks if you want to save (Save changes before you leave).

On this page