Skip to Content
Starlight

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.

⌘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.yaml lists the surfaces and the brand kit (colours and fonts).
  • scenes/ holds one .yaml file per scene.
  • assets/ holds your media, and fonts/ 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.

On this page