Settings
Settings holds your API keys, spend limits, the project's name and folder, the media cache, light or dark mode, the graphics chip, and the logs. Press ⌘, / Ctrl+, to open it.
Open Settings
Settings is one window with these pages: project, keys, generation, media, appearance and diagnostics.
- Click the gear at the far right of the top-right buttons. Or press ⌘, / Ctrl+,.
- Click a page name in the list on the left.
- Change a field, then press ⏎ / Enter or click somewhere else. Starlight saves the change at once.
- Press Esc, or click outside the window, to close Settings.
- From the menus: Starlight › Settings… (⌘, / Ctrl+,). In the command palette, type
settings…. - You can also close Settings with ⌘, / Ctrl+,, the gear, or × at the top right.
- Settings always opens on project. When the Generations panel, or ⌘K on the openrouter planner, needs a key, its link (Settings › Keys) opens keys.
- There is no Save button. A choice button (for example dark) applies when you click it.
- In a field you changed, Esc puts the old value back. Press Esc again to close.
- If a value is not allowed, a red line at the bottom of the page says why. Starlight then saves nothing.
- Canvas shortcuts do not work while Settings is open.
- Your settings are for you on this computer, in every project. Only the project's name is saved in the project.
Project: name, folder, artist name
The project page shows the open project's name, folder and mode, and your artist name.
| Field | What it does |
|---|---|
| name | The project's display name, up to 80 characters, on one line. The folder keeps its own name. See Rename a project. |
| folder | Where the project is on disk. Reveal project in Finder (Windows: Show project in Explorer) opens it. |
| how you work | Just me, on this computer, or With others, through Dropbox, with a line that says where your work is. change… copies your work and switches (How you work on a project). For “With others”, the folder button on this row opens this computer's own folder for the project. It holds the version history, renders, caches, the panel layout and the archive of conflicted copies. These never sync to Dropbox. |
| artist name | Your name for the other artists, up to 64 characters. It shows on a shared scene's padlock, and it names your Claude session logs and your brief file. |
Set your artist name.
- Open Settings and click project.
- Click the artist name field and type your name.
- Press ⏎ / Enter.
- An empty field uses your computer's user name. The field shows that name in grey.
- A new name applies at once, also to a scene you have locked.
- Starlight refuses an empty project name: a project name can't be empty.
- With no project open, the page says no project open. You can still set your artist name.
- The palette command
reveal project folderalso opens the project folder.
Team sign-in (beta)
While Starlight needs a license, every build shows the sign-in and ⌘K has no Team sign-in row. This topic is for a build that needs no license.
The tridant id sign-in is for the Starlight team only, for now. In a release build it is off. Then Starlight has no account page and no interstellar, and it does not connect to tridant id or to the Starlight Network.
Turn it on (the Starlight team only):
- Press ⌘K / Ctrl+K.
- Type
team sign-in. - Choose Team sign-in (beta). The notice says team sign-in is on.
- Open Settings › account and sign in with your team email.
- Do the same steps again to turn it off. Starlight keeps your sign-in on this computer, but does not use it. When you turn it on again, the sign-in comes back.
- A development build (
npm start) always shows the sign-in.
Keys: add an API key
The keys page stores the API keys (secret codes from each online service) that Generations, Glimpse and the openrouter ⌘K planner use.
- Make sure you are online. Starlight checks each key with its service.
- Open Settings and click keys.
- On the service's row, click set (or replace).
- Paste the key and press ⏎ / Enter, or click save. The button reads checking… while Starlight checks the key.
| Key | What it is for |
|---|---|
| OpenRouter | ⌘K compose planned in Starlight by a model that OpenRouter offers. Only for the openrouter planner. |
| Magnific | Generations: images, image and video upscales, Seedance video |
| videorouter | Generations: one key for many video models and upscalers |
| Higgsfield | Generations: Seedance 2.0 and 2.5 video. Paste the key as KEY_ID:KEY_SECRET. |
| Atlas Cloud | Generations: Seedance 2.5 video, with a 480p draft that you finish at 1080p. The key starts with apikey-. |
| starlight cloud | Upscale to surface · LTX (video versions). Your own key, from your studio admin. It has a budget for each month. |
| Glimpse | Publishing scenes to the team's LED-room Glimpse website |
| Glimpse team passcode | A Glimpse website without device sign-in. This row shows only while no Glimpse token is in use. |
- Each row shows where its key comes from:
stored,from environmentornone. A lit dot means the row has a key. - Each row has links to the service. site opens the service's website, so you can learn what it does and what it costs. get a key opens the page where you make a key (you sign in there first). The links open in your web browser. The Glimpse row links to the team's Glimpse website.
- The videorouter row also shows your balance, for example stored · $12.40 available. Money that running jobs hold shows as held. The Atlas Cloud row shows its balance too, for example stored · $31.20.
- The Magnific and Higgsfield APIs do not give a balance. Their rows say so: check your balance on their websites.
- Starlight stores the key encrypted on this machine. It never shows the key again.
- If the service refuses the key, the row says so. For example: Magnific rejected that key — check it and try again. Check the key and paste it again.
- If the service's website blocks your connection, the row says stored · not checked, the dot is yellow, and a red line says … site blocks this connection …. Your key may be fine. See Blocked connection.
- cancel, or Esc in the field, closes the field without saving.
- remove deletes a stored key. A key from the environment has no remove.
- When a service has both, Starlight uses the stored key, not the key from the environment.
- If this machine cannot store keys safely, set is greyed. The field names the environment variable to set instead, for example
OPENROUTER_API_KEY. - The Claude panel and ⌘K compose need no key here. They use your own
claudesign-in.
Keys: connect to Glimpse
Glimpse signs you in through your browser. You do not paste a key.
- On the Glimpse row, click Connect to Glimpse. The Glimpse website opens in your browser and Settings shows a code.
- Approve that code on the website. If the browser did not open, click open the page again.
- The row now shows who you are signed in as, for example connected as Dana · MacBook.
- While Settings waits, it shows how long the code still works, for example expires in 14 min.
- cancel stops the sign-in.
- If the website refuses the code, or the code runs out, the row says so in red. Click Connect to Glimpse again.
- The row can also say checking…, not connected, token refused, team passcode, or … from environment.
- paste a token: use a token that the owner gave you.
- disconnect: forget the token on this machine and cancel it on the website. The row then says disconnected — the token is revoked on the site.
- A token from the environment has no disconnect.
- A Glimpse website without sign-in uses the Glimpse team passcode row instead.
- Did you connect when Glimpse was still called Previz? Your token still works. You do not need to connect again.
- The environment variables are
GLIMPSE_API_TOKENandGLIMPSE_TEAM_PASSCODE. The old names,PREVIZ_API_TOKENandPREVIZ_TEAM_PASSCODE, still work.
Generation: planner and spend limits
The generation page picks who plans each ⌘K compose request, and sets how much AI work may cost.
| ⌘K planner | What it does |
|---|---|
| claude code | The default. ⌘K sends your words to the Claude panel, and Claude edits the scene through MCP (the link between Claude and Starlight). No key is needed. |
| openrouter | An OpenRouter model plans the request inside Starlight. Type its id in model, for example anthropic/claude-opus-4.8. It needs the OpenRouter key. |
- A line under the buttons describes the planner you picked.
- The model field shows only for openrouter. A model id uses letters, digits and
. _ : / @ + -, with no spaces.
Change a spend limit.
- Open Settings and click generation.
- Under spend, click the amount next to the limit.
- Type a new amount in US dollars and press ⏎ / Enter.
| Spend limit | Default | What it does |
|---|---|---|
| ask above | $5 | A generation that costs more shows a warning on its price before you start it. |
| MCP cap | $20 | The most that one generation started by Claude may cost. 0 stops Claude from spending at all. |
| plan cap | $1 | The most that planning one ⌘K request may cost, including its one retry. |
| Magnific $/credit | $0.001 | Your plan's price for one Magnific credit. Starlight uses it to show Magnific prices in dollars. |
- An amount must be more than 0. Only MCP cap can be 0. Otherwise the page says use an amount above 0.
- Point at a limit to see what it does and its default.
- A limit set by an environment variable (a setting from outside the app) is read-only here, with the tag
env. Point at the tag to see the variable's name.
Media: the cache and linked folders
The media page controls this machine's media cache, and where this machine finds linked media folders.
The media cache is a folder on this machine. It keeps prepared copies of videos: a fast working file, and a smaller copy (a proxy) for playback. It is for media that Starlight must not change in place: linked folders and a shared project's assets/.
The media cache row shows the cache's size and its number of clips. For example: 12.4 GB in 38 clips (6 in use). Its folder button opens the cache folder.
Set the cache size.
- Open Settings and click media.
- Type a size in GB in cap. The default is 100 and the smallest is 1.
- Click set, or press ⏎ / Enter.
- When the cache is bigger than the cap, Starlight removes the videos that were used least recently. It never removes a video in use.
- clear cache removes every video that the open project does not use. It asks first. Then it says how many it removed and how many it kept.
- Starlight prepares a removed video again the next time it needs it. It never touches your original files.
- RAM preview is the memory that cached frames may hold (RAM preview). Leave it empty for the default, a quarter of this computer's memory. Type a size in GB and click set; default goes back. It stays between 1 GB and half of the computer's memory.
Point a linked folder at your copy. A project can name media folders outside the project. Your copy of a folder can be in a different place.
- Open Settings and click media.
- Find the folder under linked folders — this machine.
- Type the folder's full path and click set. Or click browse… and pick the folder.
- This changes only your machine. The project does not change.
- Each folder shows its status, for example
folder not found on this machine — set its path below. - Under the status is the path in use. It says (this machine) for your own path, or (project.yaml) for the project's path.
- reset goes back to the path in
project.yaml. It shows only when you set your own path. - rescan reads the folders again, and checks which files are online-only.
- A project without linked folders shows none. A
media:block inproject.yamldeclares them (Linked folders).
Appearance: light or dark, graphics chip
The appearance page sets light or dark mode for Starlight. On a computer with two graphics chips, it also sets which chip Starlight uses.
- Open Settings and click appearance.
- Click system, light or dark.
- system is the default. It follows your computer's light or dark mode, and changes when your computer changes.
- Your choice applies to every project.
- In light mode the area around the surfaces (each surface is one LED output) stays mid grey. This way you never judge LED content against a white background.
- canvas sets the grey around the surfaces on this computer. Click a grey, or default to follow light or dark mode.
- The appearance never changes an export.
- This is the only place to set it. The View menu no longer has it.
Graphics chip. Many laptops have two graphics chips: a slow one that saves power (for example Intel) and a fast one (NVIDIA or AMD). Starlight uses the fast one by itself. The canvas is faster and more stable on it. To change it:
- Open Settings and click appearance.
- At graphics chip, click high performance (the default) or let Windows decide (on a Mac: let macOS decide).
- Starlight asks: Restart now? Click Restart Now, or Later. The change applies when Starlight starts again.
- The graphics chip row shows only on a computer with two graphics chips. A Mac with Apple silicon has one chip, so the row is not there.
- The line under the row names the fast chip, for example NVIDIA GeForce RTX 3060 Laptop GPU.
- On Windows, Starlight also saves the same choice that Windows Settings › System › Display › Graphics saves for Starlight. You do not need to set it there yourself.
- If Starlight must restart before it can use the fast chip, it asks one time, with the name of the chip: Starlight will use the NVIDIA GeForce RTX 3060 Laptop GPU from the next start. Restart now?
- If you chose a graphics chip for Starlight yourself in Windows Settings, Starlight never changes your choice. The line under the row then says that your own choice decides.
- After an update, Starlight saves the choice again for the new version, and removes the old one it saved.
Diagnostics: logs for support
The diagnostics page helps the person who supports you find a problem.
- Open Settings and click diagnostics.
- Click export diagnostics… and pick where to save the zip file.
- Finder (Explorer on Windows) shows the zip file. A message says what it holds.
- Send the zip file to the person who helps you.
| Row | What it shows |
|---|---|
| version | The app version |
| logs | The log folder, with a button that opens it |
| app data | The app's own data folder (settings, keys, recovery drafts), with a button that opens it |
| export diagnostics… | Saves a zip of the logs, crash reports and a system summary (GPU, ffmpeg and the formats it can write, and how fast the canvas drew: the last 10 seconds and its 5 slowest seconds) |
- The zip is named like
Starlight-diagnostics-20261021-1430.zip(the date and time). - The system summary also names the project and its number of scenes.
- The zip has no project files, media or keys. Starlight removes secrets from the logs. It uploads nothing.
- Environment variables can change some settings for one launch. If any are set, a line lists their names: env overrides this launch: ….
- The Help menu has the same two items, under Troubleshooting. On a Mac: Help › Troubleshooting › Reveal Logs in Finder and Help › Troubleshooting › Export Diagnostics…. On Windows the first one is Show Logs in Explorer.
- The Troubleshooting items work even when no project opens.
Claude
The Claude panel runs Claude Code, an AI assistant, beside the canvas. You ask in plain words, Claude changes the project, and you watch the canvas.
Projects & sharing
A project is one folder with its surfaces (the LED outputs), scenes, media, history and memory. This section shows how to make, open, save and share projects.