Skip to Content
Starlight

Glossary

Short meanings of the words Starlight uses, in six groups.

Some words have two meanings in Starlight: layout, token, matte, reference, grade, hold, lock, draft and sheet. Their entries say which is which.

Scenes, surfaces and layers

Venue
The building with the LED walls, for example an arena or a theatre. In Glimpse it is a 3D model.
Surface (screen; once called wall or board)
One LED output at its real pixel size, for example N, E1, S or STAGE. Each surface exports as its own file. The YAML key is surfaces:. In this guide, a wall is only a real wall: an LED wall, or a wall of the room in Glimpse.
Ribbon
A long, thin surface, for example an LED band that goes around the arena (Ribbons).
Output size (output resolution)
The pixels Starlight renders for a surface: its real LED size. The YAML key is size.
Design size (artboard)
The canvas a comp is made on: 1920×1080 unless you change it. The fit scales it into the surface's output size. The YAML key is design.
Pixel map
The LED company's plan of the LED walls and their sizes in pixels.
Scene
One piece of content for all the surfaces, saved as a file in scenes/. A project has many scenes.
Comp
A named group of layers, listed under a scene's comps:. You place a comp on one or more surfaces with use:. Build it once, show it on many surfaces.
Layer
Something that is drawn: text, an image, a video, a shape, a gradient, and more. Layers stack: a later layer draws on top.
Node
A layer, comp, surface or clock, drawn as a box in the node graph. In YAML, a node is a map with one keyword (text, shape, transform…) that says its kind.
Branch
In the node graph, one chain of nodes that feeds a comp or a surface: for example a video, its transform and its effects. ↑ and ↓ move from one branch to the next (Select and navigate).
Frame (of a comp), framed comp
A fixed size that a comp can have, for example 2520×1080. A framed comp is a box: it crops its content to the frame. Use it to make an exact AI input (Comps with a frame).
Frame guide
The orange outline of a framed comp on the canvas. It shows while the comp is selected, or while you are inside the comp. It is never in an export. View › Frame Guides hides or shows it (Comps with a frame).
Pre-comp
To move selected layers into a new framed comp, with one use: of it in their place. Nothing moves on screen.
Subtree
A node and everything inside it. group into subtree moves the selected layers into a new comp named subtree.
Graph level, breadcrumb
The graph level is what the node graph shows at one time: the top level, or the inside of one comp. A click on the canvas picks a layer at this level. The breadcrumb is the path at the top of the node graph. It shows which level you are in.
Wire, feed (feed wire)
A wire is a line between two nodes in the node graph. A feed wire goes from a comp to a surface. The comp feeds the surface, so the surface shows it (use:).
Ref (use)
One placement of a comp. At the graph's top level it is one layer. Go into the comp to edit what is inside.
Transform
The layer that places what is inside it: position, scale, rotation, anchor and opacity. Put anything you want to place inside a transform.
Anchor (pivot)
The point that a layer turns and scales around. It is a setting of the transform.
Matte (mask)
A node that cuts one layer (the content) to the shape of another layer (the matte). It uses the matte's alpha or its brightness (luma). The matte layer itself is not drawn. feather softens the edge, and invert keeps the outside. A packed matte is something else: a video that keeps its colour and its alpha side by side in one file.
Feather
A soft edge on a matte or a mask, in pixels. 0 is a hard edge (feather).
Adjustment layer (adjust)
A layer with no picture of its own. Its effects, opacity and blend mode change every layer below it in the same list.
Effect
A change to how a layer looks, for example a blur or a glow. A layer can have several, one after the other. In the node graph, each one is a small effect chip after its node.
Param
One setting of an effect, for example a blur's amount.
Colour op
An effect that changes only colours: exposure, levels, curves, hue/saturation and more. To grade colour means to change it with colour ops.
LUT (look-up table)
A colour table. Starlight joins all colour ops of a layer into one LUT, so they cost almost nothing. A .cube file is a LUT that you can load.
Blend mode (blend)
How a layer mixes with the layers below it, for example screen or multiply. normal simply covers them.
Bypass
Switch off what a node adds, without deleting it. A transform or group still shows its layers; a picture or video hides. Works on a layer, an effect or a whole comp. Press b, or click the round switch on the node. In YAML it is bypass: true.
Alpha
How see-through each pixel is. A video with alpha has parts you can see through.
Cutout
An effect that removes the background from a photo. A Mac makes it on your computer and saves it in the project, so Windows shows it too (Cut a subject out of a photo).
Path, pen, subpath
A path is a vector shape that you draw with the pen tool. A subpath is one line or one closed shape inside a path.
Gradient stop
One colour of a gradient, at a place from 0 (the start) to 1 (the end).
Token
A colour name such as $primary. It points to a colour in the brand kit or the scene theme. The MCP server's access token is something else (AI, Claude and Glimpse).
Theme
A scene's own token names, under theme:, for example primary: $team.gold. They point to the brand kit.
Brand kit
The project's colours and fonts, under brand: in project.yaml.
Fit
How a comp fills a surface: none, fill, cover, contain, tile-x or tile-y.
Band-native
A ribbon is a long, thin surface. A band-native comp is made at the ribbon's real height, with its own design size. Tiling then does not shrink it.
Cloner (clone)
A layer that repeats one source (an asset or a comp) many times, in one fast draw.
Belt
A cloner that drifts sideways forever. It loops with no visible jump (no seam) when drift × loop is a whole number of gaps.
Stagger
A small delay for each copy of a cloner, so one animation ripples down the row.
Seam
A visible jump: where a loop starts again, or where two tiles of a ribbon meet.
Asset
A media file that the project uses: an image, a video, a sound, a font or a LUT. Assets are in assets/, or in a linked media folder.
Extension
Code in the project's extensions/ folder that adds effects or layer types. Starlight runs it only after you trust it (Trust a project's extensions).
Shader, uniform, reach
Words for writing extensions. A shader is a small program that the GPU runs for each pixel. A uniform is one value given to the shader: one per param. Reach is how far around each pixel the shader reads.
Recipe
A ready block of scene YAML in the Cookbook.

Time and motion

Loop (scene loop)
The scene's length. Playback and exports repeat it with no jump.
Dropped frame
A frame that the live canvas skips because the computer is too slow to draw it in time. Playback stays in time with the sound. An export renders every frame (When your computer cannot keep up).
Scene clock (main clock)
The large dial at the right of the node graph. Its period is the loop. A layer's clock with no period of its own follows it. To make it bigger, drag the small handle beside its name (Make the scene clock bigger).
Clock
A timer that plays the keyframes of a layer or an effect. It has a period (its length) and a mode. The modes are loop (repeat), once (play, then hold) and pingpong (forward, then back).
Named clock
A clock with a name, under clocks:. Many layers can use it, with clock: { use: <name> }. One change to it retimes them all (Named clocks).
Dial
A clock, drawn as a round face in the node graph. Rings around it show the keyframes of the layers it drives.
Period
A clock's length. The scene loop must be a whole number of periods. If it is not, the clock is amber in the graph.
Phase
A position in a clock's period, from 0 (start) to 1 (end). Keyframes are placed by phase.
Frame, fps
A frame is one picture of the video. fps (frames per second) is how many frames play in one second. A scene has 30 fps unless you change it.
Playhead
The marker of the current time, on the timeline and in the transport.
Transport
The play button and the time, at the bottom left of the canvas (Transport and playback).
Scrub
Drag through time to see the frames, or scroll over a clock (Scrub to a time). Dragging a number's label to change the number is also called scrubbing.
Keyframe
A value at a moment, for example "scale 1.2 at phase 0.5". Starlight moves the value from one keyframe to the next.
Track, lane
A track is one animated property of a layer, such as x or scale, with its keyframes. On the timeline each track is one row, called a lane. An audio track is the sound file of an audio layer.
Ease
The shape of the motion between two keyframes. Each name below is an ease. See Eases.
smooth
Starts gently and stops softly. The default ease.
linear
The same speed the whole way. Use it for a steady spin or drift.
ease, ease-in, ease-out, ease-in-out
The standard web curves. ease-in starts slowly; ease-out ends slowly; ease-in-out is slow at both ends; ease starts fast and ends slowly.
snap
Waits, moves very fast, then stops hard. Use it for a hit.
overshoot
Goes past the target, then comes back to it. Use it for a pop.
expo-in, expo-out, expo-in-out
The exponential curves. expo-out moves at once and then slows for a long time (a settle); expo-in is the reverse (a launch); expo-in-out is still, very fast, then still.
back-in, back-in-out
Wind-ups: the value pulls back the wrong way before it leaves. back-in-out also goes past the target, like overshoot.
hold
Keeps the value until the next keyframe, then jumps. No motion between. The grade hold in Generations is something else.
steps(n)
Moves in n equal jumps, like a ticking counter. steps(n, start) jumps at the start of each step.
elastic
Swings past the target a few times, smaller each time, like a rubber band.
bounce
Hits the target and bounces three times, smaller each time.
spring
Moves like a spring: a quick wobble that settles on the target.
Hit, pop, settle
Words for kinds of motion. A hit is a sharp move on a beat. A pop is a quick grow that goes a little too far, then comes back. A settle is the slow end of a move, as it comes to rest (Design craft).
Cue, trigger
A cue is a named phase on a clock. A trigger starts another clock (at its phase 0) when this clock reaches the cue.
Gate, gate span
A gate shows a layer only at set times of its clock. Each stretch where the layer shows is a gate span: a bar in the gate lane of the timeline (The gate).
Drive (band driver)
Makes a property follow the music, for example the bass or the kick drum. While it plays, it replaces that property's keyframes (Band drivers).
Tracking data
The place of a point in a video on each frame, made by a tracker (After Effects, Mocha, or a script). A layer can follow it (Import tracking data).
Plate
The video layer that shows the footage the tracking data was made on.
Confidence
How sure a tracker was about the point on one frame, from 0 (not sure) to 1 (sure).
Bake
Turn a drive into ordinary keyframes, with ⧉ (Bake a driver to keyframes).
Clip
A video or audio layer, shown as a bar on the timeline.
Bar
A layer's strip on the timeline, from its in point to its out point.
In point, out point (span)
When a layer starts and stops showing in the loop. The YAML saves them as span, for example span: [1s, 3s].
Delay (time offset)
How much later a layer, and everything inside it, runs. Moving a layer in the timeline changes it, so the keys move with the layer (Delay a layer).
Trim
Move the start or the end of a layer's bar, so the layer shows for a shorter time (Trim a layer).
Slip
Keep a clip's bar where it is, and slide the video inside it, so other frames play (Slip a clip).
Edit point
A time that ↑ and ↓ jump to on the timeline. It is the start or the last frame of the loop, or a layer's in or out point.
Snapping
You drag a bar, a keyframe or the playhead near an edge, a marker or a keyframe. It then jumps onto it (Snap).
Marker
A named, coloured moment on the timeline, for example "logo hit". Press \ over the timeline to add one at the playhead. A marker is a note only: unlike a cue, it controls nothing.
Layer marker
A marker on a video, at one frame of the clip. It moves with the clip when you slip it (Mark a frame in a video).
Work area
A part of the loop that playback repeats, with the timeline open or closed. Press i and o to set it, from anywhere. The loop chip next to the time shows it, and its × clears it. It is for viewing only: exports and Glimpse always use the whole loop.
Maximize (a panel)
Make one panel fill the window for a while, with `. The other panels are hidden, not closed. Press ` again to put them back (Make a panel fill the window).
Layers view, curves view
The timeline's two views. The layers view shows every layer as a bar. The curves view shows the curves and keyframes of the selected animated layer, one lane for each property. ⌥T / Alt+T switches between them. The curves view was called the keyframes view before.
Curve
A graph of a property's value over time, in the curves view. Drag keyframes and handles to shape the eases (Curves and eases). It replaces the old curve editor (graph editor).
Solo, lock (timeline)
Two switches on a timeline row. Solo shows only the soloed layers. Lock stops a layer from being picked or moved on the canvas. Both are for previews only. A timeline lock is not a scene's edit lock.

Views, tools and files

Panel, rail, pin
A panel is one part of the window, such as Properties or Assets. A panel can float, dock to an edge (a rail), or be pinned to a point (Float, dock and pin a panel). Several panels can share one place as tabs (Put panels together as tabs).
Canvas
The big view where all the surfaces are drawn. You select and move layers there.
Pan, room zoom
To pan is to move the view sideways without zooming. Room zoom is the view that fits the whole room on screen (⇧1 / Shift+1). The surfaces then play their proxies.
Node graph
The panel where every layer, comp, surface and clock is a node, joined by wires (The node graph).
Sticky note
A note that you put on the node graph. It is saved in the scene, but never drawn on a surface.
Properties, sheet
Properties is the panel for the settings of the selected node. One node's settings are its sheet. A small window, such as the export sheet, is also called a sheet.
Value ladder
A way to drag a number in steps. Hold the middle mouse button on the number. Move up or down to pick a step, from 100 to 0.01. Then move sideways to change the value (Change a value).
Gizmo, handles
The gizmo is the box around a selected layer on the canvas. Its handles are the squares, the knob and the cross that you drag to scale, turn or move the layer and its anchor. In the curves view, handles shape a curve (Shape a curve with handles).
Marquee
A box that you drag to select several things at once. On the canvas and in the node graph, right-drag.
Hint
A short help line, for example in the timeline's header. It says what a click or a drag will do.
Notice line
A short message at the top middle of the window, for example saved 01-intro.yaml. It goes away after 2 to 10 seconds (a longer message stays longer), or when you click it.
FPS HUD
A small readout of how fast the canvas draws. Press ⇧I / Shift+I, or choose View › Frame Rate (See how fast the canvas draws).
Render
To draw the scene's pixels. The canvas renders live; an export renders every frame into a file; render_still renders one frame.
Ingest, working file (all-intra)
Ingest prepares an imported video. It writes a working file in which every frame is stored whole (all-intra), so scrubbing is instant. Ingest runs in the background. The notice line shows how many videos are done, for example ingesting 9 / 24 (Video ingest and proxies).
Deep file
A second copy of a video with more than 8 bits or full colour (4:4:4): the same frames at 10 bits or more. Only a 16-bit export reads it; the canvas plays the working file (Video ingest and proxies).
Proxy
A quarter-size copy of a large video. The canvas plays it when you zoom out, so playback stays fast. Exports always use the full-size file.
Media cache
A folder on this computer for the working files and proxies of linked and shared videos (Settings › Media).
Projects screen
File › Projects: your recent projects, with new project… and open… (The Projects screen).
First surface
Of the surfaces a scene shows content on, the highest one on the canvas, and of those at that height the one most to the left. The scene list shows a small picture of it for each scene, at most 640 pixels wide (Open the scene list).
Scene order
The order of the scenes in the scene list. The next and previous scene keys, the command palette and the reel use it too. Drag a scene in the list to change it. It is saved in project.yaml as sceneOrder: (Change the scene order).
Outline (scene list)
What a scene shows in the scene list until its picture is ready: the shape of its first surface, with a faint picture of its first image or video. Starlight makes the real picture in the background, also while the show plays.
Surface arrangement (surface layout)
Where each surface sits on the canvas. It changes only your view, never the output. One arrangement serves every scene of the project. It is saved in the file layout.json: in a local project in .starlight/, and in a shared project on each computer (Arrange the surfaces).
Layout preset
A saved arrangement of the panels, in Window › Layouts (Save and restore a layout). A stage's layout is something else: its grey capture image.
Command palette (command bar)
One search box for every command and layer type, and for words to Claude. Open it with /, ⌘/ / Ctrl+/ or ⌘K / Ctrl+K (The command palette).
⌘K compose
Type what you want in the command palette and pick ask Claude. Your words go to the Claude panel as a message, and Claude makes the change. With the openrouter planner, a model plans inside Starlight instead.
Placeholder
A stand-in, such as a grey image or a short black video. ⌘K compose puts it where new media will go, until the generation arrives.
Viewer
The node graph's viewer (v). The surface that a selected node feeds shows that node's result, in a thin grey frame.
Focus
Canvas focus (f). Only the surfaces that the selected comp feeds show and render. It changes the view only, never an export.
Generation preview
A finished AI result shown full size in the canvas pane (Preview a result).
Stage, capture
A stage is a 3D sketch of a shot for one AI generation: clay shapes, posable figures and a real lens. You make it in the Stage panel. It is not the canvas, and not a surface named STAGE. A capture is the stage's grey layout picture in assets/stages/, which the AI model reads (Stages).
Version (checkpoint)
A snapshot of the project. Starlight makes one on every save and on every change it makes for you (Claude, imports, captures). Restore one with the v button at the top right. A restore never deletes files made later: a newer scene stays. In a shared project, versions are kept per computer and hold only project.yaml, the scenes and the extensions.
Recovery draft
Unsaved edits that Starlight keeps on this computer when you leave a scene or the app closes. A card in the lower left of the canvas offers them back (Get unsaved edits back). A Seedance draft in Generations is something else.
schemaVersion
A number at the top of a scene file. It says which version of the file format the scene uses.

Export, video and your computer

Export
Render a scene into video files, one file per surface (Export video).
Export sheet
The small window that opens when you export (⌘E / Ctrl+E). You pick the format, the fps and the surfaces there.
Reel
An export of every scene, one after the other (Export the reel).
Export size
The pixel size of an exported file. It is the surface's LED size, or the artboard's size for a master (Export a master at the plate's size).
Export monitor
The small ring next to the time, its text, and up to three thin lines along the bottom edge. They show a running export in three levels: blue for the project (all its scenes), mint green for the scene (all its surfaces), violet for the surface (the file it writes now) (Follow or cancel an export).
Canceled export
An export that you or Claude stopped before it ended: with the box, Esc, or Claude's cancel_export. It is not an error. The finished surfaces are kept (Follow or cancel an export).
Interpolate
When you export at another fps than the scene's, make new in-between frames for smoother motion. Without it, frames are copied or dropped.
Codec (H.264, HEVC, ProRes)
The way a video file is packed. H.264 and HEVC (also called H.265) make small files. ProRes makes large, high-quality files, and can keep alpha.
HAP Q
A video codec that the graphics card unpacks. Media servers use it. The files are large. Export it only when a media server asks for HAP (Formats).
Encoder
The part that writes a codec. A hardware encoder uses a chip in the computer. It is much faster than a software encoder such as libx265 (HEVC 10-bit and the encoders).
ffmpeg
The video program that is part of Starlight. It imports and prepares video, and it writes the export files.
GPU
The graphics card. The canvas, the effects and the exports draw on it.
Logs, diagnostics
The logs are the app's record of what it did. Diagnostics is one zip file of the logs, to send to the person who helps you (Send diagnostics).

AI, Claude and Glimpse

Generation
One AI job that makes an image or a video (Generations).
Prompt
The words that describe what the AI should make.
Model
The AI that makes the result, for example Seedance or Flux.
Provider
The online AI service that runs the job: Magnific, videorouter.sh, Higgsfield or Atlas Cloud.
API key
A secret code from your account on a provider's website. Starlight needs it to run jobs for you (Settings › Keys).
Cloudflare, blocked connection
Cloudflare is a security service in front of some providers' websites. It can block a connection, for example from some countries or networks. The provider then never sees the request (Blocked connection).
Ray ID
Cloudflare's code for one blocked request, for example a51c3c1bea7b5bac. Send it to the provider's support.
Quote
The price of a job before it runs. Most prices are estimates (Check the price before you spend).
Start frame, reference image
A start frame is the first frame of a video job. A reference image shows the model a subject or a look to follow. Neither is a Claude reference.
Upscale, tiled upscale
An upscale makes an image or a video bigger and sharper. A tiled upscale makes the result in parts (tiles), as big as a whole surface (Upscale a result).
Draft (Seedance)
A cheap, quick 480p preview video on videorouter or Atlas Cloud. Within 7 days, finish at 1080p makes the full video from it. videorouter finishes each draft once (Draft). It is not a recovery draft.
Final (of a draft)
The 1080p job made from a draft with finish at 1080p. It is the same take as the draft, at full size.
Grade
Your mark for a generation result. Press 1–6: circled (the one), select (a keeper), hold (not decided), soft (nearly), NG (no good), ref (a frame to generate from). See Grade results. A colour grade, made with colour ops, is something else.
Claude Code, Claude panel, terminal
Claude Code is an AI assistant from Anthropic that works in a terminal: a window for typed commands. The Claude panel (⌃` / Ctrl+`) runs it inside Starlight (Claude).
Chat, tab
Each tab of the Claude panel is one chat: a separate Claude Code session with its own conversation.
Reference (Claude)
A name in square brackets that Starlight types into Claude's prompt, for example [scene 02-walls]. It tells Claude exactly what you mean (Point Claude at what you mean). It is not a model's reference image.
Skill
A short guide that teaches Claude how to work in Starlight. Some come with the app. A project can add its own in .claude/skills/.
MCP, MCP server
MCP (Model Context Protocol) is how AI tools such as Claude talk to Starlight. The MCP server runs on this computer, and gives them tools such as read_scene (The MCP tools).
Access token
The MCP server's secret code, in .mcp.json and .starlight/mcp-token. It is not a colour token.
Glimpse
A 3D view of the venue with your surfaces in it (⇧R / Shift+R), and the team's website with the same room. Before Starlight 0.2.16 it was called Previz. See Glimpse.
Feed width
How many pixels wide the Glimpse room draws each surface's picture, for example 1024 (Feed size, not full size).
Look, publish, pull
A look is a scene on the Glimpse website: the 3D room with one video per surface. Each look has its own name: two looks never have the same name. To publish makes a look, or replaces a look after you say yes. To pull downloads a look's videos into assets/previz/ (Publish to Glimpse).
Dry run
A test that shows what would happen and changes nothing. Claude does one before a Glimpse publish.
Playback copy
A smaller copy of a surface's video that Starlight uploads with each Glimpse publish: HEVC at full size and H.264 at half size. Browsers play the copies smoothly. Your video stays the master (Publish to Glimpse).

Shared projects and memory

Shared project
A project inside Dropbox (or OneDrive, Google Drive, iCloud Drive or Box). The scenes, assets, renders and project.yaml sync. The history and caches stay on each computer.
Edit lock
A mark that says who is editing a scene in a shared project. Your first edit takes the lock. Only looking at a scene never takes it (Lock a scene). It is not the timeline's lock switch.
Padlock chip
The padlock to the right of the scene name, at the top right. Open and faint: free. Closed: yours. Closed with a name: someone else has it.
Read-only
A scene that someone else has locked. Your edits are undone at once, and save is refused, until the lock is free or you click edit anyway.
Conflicted copy
A second file that Dropbox keeps when two computers save the same file before it syncs. Starlight asks you to keep mine or use theirs.
Online-only file
A Dropbox file that is not on your disk yet (☁). Starlight cannot use it until you make it available offline (Online-only files).
Linked media
A media folder outside the project, listed under media: in project.yaml. Scenes use its files where they are, as media:<root>/<path> (Use linked media).
Brief
The project's record of what each artist asked for, by date and scene. Claude keeps it in context/direction/. With the session logs in context/sessions/, it is the memory the next session starts from.

On this page