Known quirks (0.2.3)
Problems and limits in this version, so that they do not surprise you during a job.
Saving and versions
What saving, loading and restoring do that you may not expect.
- Saving rewrites the scene file. ⌘S / Ctrl+S writes the file in Starlight's own layout. YAML comments and your own formatting are lost. Put notes in sticky notes on the node graph instead.
- A restore does not delete newer scenes. A restore writes back every file that the version holds. A scene you made after that version is not in it, so its file stays. If a restore shows extra scenes, delete them by hand.
- A restore never goes back in the project memory.
context/(the Claude sessions and the brief) stays as it is.
Animation
Two clock behaviours that may surprise you.
- A trigger sets a start point, once per loop. A trigger lines a clock's phase 0 up with a cue on another clock. In each loop, the clock waits at phase 0 until that moment, then runs freely to the end of the loop. If the other clock reaches the cue again later in the same loop, nothing restarts. A cue that no clock triggers from does nothing.
- A layer's own clock with its own
periodhas no keyframe rings in the graph. (A ring shows one animated property, with a tick for each keyframe.) Rings grow only on the scene clock's dial and on named clocks' dials. The animation still plays and shows on the timeline. To see the rings, use a named clock (clock: { use: … }). Or leave outperiod, so the clock follows the scene loop.
Video and audio
How sound and media files work in a scene.
- A video's sound has no volume control. With muted unticked, a video plays its sound at full volume. To set a volume, put the soundtrack on an
audiolayer instead. - A missing file draws nothing. A layer whose file is missing, broken or online-only draws one white pixel, so you see almost nothing. The line at the bottom left of the canvas names the file (missing media: …). The layer stays in the node graph and in Properties. Check the badges in the Assets panel (Find missing media).
Timeline
What the layer timeline cannot do yet.
- No speed change, reverse or freeze frame for a video clip yet.
- All layers that play the same video file slip together. Starlight uses one decoder per file, so they share one
offset(Slip a video clip). - A comp placed with
use:cannot be slipped like a video. You cannot shift the time inside it. The bottom half of its bar's edge trims, as on other layers that are not videos.
Stages
Limits of stages (3D sketches of a shot) in this version.
- The MCP tool
stage_capturesees the saved scene. Save first. - Saving writes a stage's vectors (its 3D positions) with one value per line. It also drops comments, as it does for the whole scene. The MCP tool
stage_writekeeps the comments, and writes each vector on one line, for example[0, 1.6, 4]. - Each new capture adds a PNG of about 100 to 300 KB to the project's history (in a project that is not shared). There is no way to remove old ones yet.
- Two captures in a row run one after the other.
- A
stage:source cannot be a generation input yet. Capture the stage, then use the PNG.
Shared projects
Limits of shared Dropbox projects in this version.
- Keep every computer's clock right. An edit lock uses the time of the computer that holds it. A clock more than 5 minutes slow makes that computer's locks look expired to the others. Turn on the automatic date and time in the system settings.
- Versions hold only
project.yaml, the scenes and the extensions. A restore does not bring back assets or fonts (Save and go back to a version). - A font that arrives later does not load by itself. If a font file finishes downloading after the project opens, click ↻ in the font row of a text layer's Properties. Or open the project again.
- Only scenes and
project.yamlget conflict checks. Starlight does not list a conflicted copy of an asset, a font or an extension (Resolve a conflicted copy). - A delete check can miss a scene. Starlight refuses to delete an asset that a scene uses. A scene that is still online-only is not checked, so an asset that only that scene uses can be deleted.