What Starlight is
Starlight is a desktop app. You use it to make the content for every display in a venue: LED walls, video screens and ribbon displays.
In Starlight, each display is a surface: one output, at its real pixel size. One canvas shows every surface. One clock plays all the surfaces together, in a loop. You export one video file per surface.
Four ways to work
You can work in four ways. You can mix them, because they all change the same scene.
- By hand: use the canvas, the node graph, Properties and the timeline.
- With AI: describe a change in plain words with ⌘K compose. Make images and video with Generations.
- With Claude: the Claude panel (⌃` / Ctrl+`) runs Claude Code inside Starlight. Claude can change the open project for you.
- As text: every scene is a plain YAML file. You can edit it in any text editor (Scenes in YAML).
⌘K compose, Generations and Claude need the internet. The Glimpse panel and publishing to Glimpse need it too (Working offline).
Undo and versions.
- ⌘Z / Ctrl+Z undoes your own edits and ⌘K changes.
- Starlight saves each change that Claude makes as a version. So you can go back (Undo Claude's change).
- After you edit the YAML in a text editor, load it with File › Reload Project from Disk (⌘R / Ctrl+R).
The window at a glance
What you see when a project is open, and where each part is explained.
- Canvas (left): every surface, flat and at its true size. You select and place layers here (Canvas).
- Node graph (right): the scene as nodes and links. Press g to show or hide it (Node graph).
- Transport (bottom left of the canvas): play, the time and the frame rate (Transport & playback).
- Top right: the scene name and, in a shared project, the padlock. Click the scene name to open the scene list. Then the audio monitor, v for versions, ? for this guide and the gear for Settings (The top-right buttons). On Windows they are in the title bar.
- Panels: Properties, Assets, Generations, Glimpse and Claude. They open when you need them, and each one has a key (The areas and their keys).
- First start: the first time you start Starlight, the Claude panel is already open, large, on the right. Ask it for what you want to make. If Claude Code is not installed yet, the panel offers to install it: click Install Claude Code (Open the Claude panel).
- Timeline: it opens at the bottom with ⇧T / Shift+T. It also opens by itself when you animate something (Timeline).
There is no toolbar. To run any command by its name, press / for the command palette (The command palette).
What a project is
A project is a folder. It can be on your computer, or in Dropbox or another synced folder.
project.yamllists the surfaces and the brand kit (colours and fonts).scenes/holds one.yamlfile per scene.assets/holds your media, andfonts/holds your fonts.- Every save (⌘S / Ctrl+S) is a version that you can bring back.
- A project in Dropbox is shared: several artists can open it at the same time (Shared projects).
- The other files in the folder: What is in a project.