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 withuse:. 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.feathersoftens the edge, andinvertkeeps 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
.cubefile is a LUT that you can load. - Blend mode (
blend) - How a layer mixes with the layers below it, for example
screenormultiply.normalsimply 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 exampleprimary: $team.gold. They point to the brand kit. - Brand kit
- The project's colours and fonts, under
brand:inproject.yaml. - Fit
- How a comp fills a surface:
none,fill,cover,contain,tile-xortile-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
designsize. 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 × loopis 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) andpingpong(forward, then back). - Named clock
- A clock with a name, under
clocks:. Many layers can use it, withclock: { 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
xorscale, 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-instarts slowly;ease-outends slowly;ease-in-outis slow at both ends;easestarts 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-outmoves at once and then slows for a long time (a settle);expo-inis the reverse (a launch);expo-in-outis still, very fast, then still. back-in,back-in-out- Wind-ups: the value pulls back the wrong way before it leaves.
back-in-outalso goes past the target, likeovershoot. 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 examplespan: [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
loopchip 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_stillrenders 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.yamlassceneOrder:(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 inassets/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.jsonand.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.yamlsync. 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:inproject.yaml. Scenes use its files where they are, asmedia:<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 incontext/sessions/, it is the memory the next session starts from.