Effects
Effects change how a layer looks, for example a blur or a glow. They run on the graphics card, one after the other.
Add effects to a layer
Add an effect in the app, or write it in the layer's effects: list.
- Select the layer.
- In Properties, click + on the title row of the effects section. Or open the command palette (/, or ⌘/ / Ctrl+/) and type the effect's name.
- Pick the effect.
- The picker has a color column and an effects column. When an extension adds effects, an extensions block shows below them.
- In the picker, type to filter the list. Use the arrow keys to move, and press Enter to add. Esc closes it.
- Each effect gets a card in Properties, with its own buttons (Add effects and colour ops).
- From the palette, with a layer selected, the effect goes on that layer. With nothing selected, Starlight makes a new adjustment layer with the effect. With a comp selected, the new adjustment layer goes inside that comp.
- The palette does not add an effect to a clock, a surface or an audio layer. It says why.
cutoutis offered only on an image layer that does not have it yet.
In YAML it looks like this:
effects:
- glow: { color: $primary, threshold: 0.35, radius: 8,
intensity: [0.15, 0.9, 0.2] } # a keyframe list: follows the layer's clock
- chroma-shift: { angle: 0, offset: [0, 7, 0], clock: { period: 1s } } # its own clock
- blur: { amount: 6, bypass: true } # bypassed (turned off)
- Each entry is a map with one key: the effect's name. Its params (its settings) go inside. An entry with no key or with two keys is an error.
- The params must be a map. Write an effect with no params as
- cutout: {}. - A param is a constant or, if it can be animated, a list of keyframes.
- A constant is a number, a colour (
"#hex"or$token), or a choice likecurve: linear. Colour and choice params cannot be animated. - A param you do not set uses its default.
clock:andbypass:inside an effect are reserved keys, not params.- Effects run from top to bottom, with two exceptions.
cutoutalways runs first. Then all colour ops of the layer run, as one colour table. Then the other effects run, in list order. - If you type an unknown effect name in YAML yourself, Starlight keeps it in the file but draws nothing for it. It may be an extension that is not loaded.
Animate an effect
An effect's keyframes follow a clock, like the layer's own motion.
- The keys use the layer's clock: its period, or the named clock it uses. So they move with the layer's transform keys.
- If the layer has no clock, the keys use the scene loop.
- A
clock: { period, mode }inside the effect gives the effect its own clock. With noperiod, it uses the scene loop. It cannotuse:a named clock. - You can set an effect's own clock only in YAML.
In the app:
- In Properties, find the param. Every param that can be animated has a ◇, like any other row (see Keyframe a property).
- Click the ◇ to add a keyframe at the playhead.
- To use a named clock, drag the ◇ onto that clock's dial. The layer, and the effect with it, move onto that clock.
- Dropped on the scene dial, the ◇ keeps the timing as it is.
- Remove the last keyframe and the param becomes a constant again.
- The keys show in the timeline like any other keys.
- A card with animated params names the clock that times them. For example, it says keys ride the scene loop or keys ride ⟲ beat (a named clock). The other notes are keys ride this layer's animation and keys ride this effect's own timing.
- Colour and choice params have no ◇.
- Tip: put an effect on the same clock as the motion. A glow that flashes on the pop, or a colour split that snaps with the skew, looks planned.
Turn one effect off
Turn off one effect, but keep it in the list. The layer then looks as if the effect were not there.
- Select the effect's chip in the node graph and press b. Or click the ⊘ on its card in Properties.
- You can also right-click the chip and choose bypass and the effect's name, for example bypass glow. The same menu has properties and remove effect.
- To remove the effect, select its chip and press ⌫ / Backspace, or click × on its card.
- In YAML this is
bypass: trueinside the effect. It is a reserved key, not a param. Starlight dropsbypass: falsewhen it saves the scene. - A bypassed
cutoutshows the photo with its background.
Built-in effects
These effects come with Starlight. "Animatable" lists the params you can keyframe.
| Effect | Params (default) | Animatable |
|---|---|---|
depth | No params: write - depth: {}. Images only. Shows the image's grey depth map: white is near. It is a matte: it only cuts, as the matte of a cut by its own image (Mattes of a clip). A Mac makes the map once and saves it in the project, in assets/.depth/. When there is no map, the image shows without the cut. Scene version 18. | — |
cutout | No params: write - cutout: {}. Images only, once per image, and not on an adjustment layer. Removes the background and keeps the subject. A Mac makes it with macOS Vision and saves it in the project, in assets/.cutouts/, so every computer shows it. When no cut-out is saved and this computer cannot make one, the original photo shows and the canvas says cutout not made yet – open on a Mac to make it. It runs before everything else in the list. | — |
blur | amount 8 (the strength in px), quality 4 (the number of passes, 1 to 5). A soft blur. | amount |
sharpen | amount 0.5. 0 is off. About 0.3 to 1 makes text and fine detail crisp. | amount |
glow | color #ffffff (a #hex or $token), intensity 0.6, threshold 0.5 (0 to 1), radius 6 px. Pixels brighter than the threshold glow in the colour, out to the radius. | intensity, threshold, radius |
chroma-shift | offset 4 px, angle 0 (in degrees, 0 = to the right). Splits the red, green and blue colours apart. Red moves along the angle, blue the other way. | offset, angle |
pixelate | size 8 px. A mosaic of square cells. It also works as an LED preview look. | size |
halftone | size 6 px, angle 45 (degrees), amount 1 (0 to 1). A print-style dot pattern: darker pixels get see-through dots. | size, angle, amount |
grain | amount 0.2 (0 to 1), size 2 px, seed 0. Film-style noise that darkens. Animate seed, for example [0, 1], to make the grain move. | amount, seed |
noise | scale 200 px, octaves 3 (1 to 6), evolve 0, seed 0, amount 1 (0 to 1). Makes soft grey cloud noise in the layer's own pixels. It replaces the colour and keeps the alpha. scale is the size of the blobs. octaves adds finer detail. evolve moves the noise in time. Evolve 0 and evolve 1 give the same picture, so evolve: [0, 1] loops with no jump. seed gives a different pattern. | evolve, amount |
threshold | level 0.5 (0 to 1), softness 0.1 (0 to 1). Makes each pixel white or black. A pixel brighter than level becomes white. A darker pixel becomes black. The alpha stays. softness makes the edge soft (0 = a hard edge). Level 0 is all white and level 1 is all black. Put it after noise on a white rectangle. Group the rectangle with a black one under it, and use the group as a luma matte (effects on the matte layer itself do nothing). Then animate level from 0 to 1 to dissolve a clip in patches. | level, softness |
feather | left / right / top / bottom 0 px (in the layer's own pixels; 0 = off), curve smooth (default) | linear. Fades the edges to transparent. To blend two tiles that overlap, feather only the overlap of the top tile, over a solid bottom tile. If you feather both tiles, the join gets darker (75%). | left, right, top, bottom |
| colour | exposure, brightness-contrast, hue-saturation, levels, curves, color-balance, temperature-tint, invert, lut (a .cube file in assets/). All colour effects of a layer join into one colour table (a LUT). It runs before the other effects, wherever they are in the list. Their params: Colour ops. | the number params (not the curves, the LUT file or the on/off switches) |
- Extensions can add more effects (see Extensions).
- The MCP tool
get_projectlists every effect with its params. It marks an extension's effects withextension: true. - When Claude writes a scene, Starlight refuses an unknown effect or param, and names it.
Colour ops
A colour op changes each colour on its own, like a colour correction in After Effects. These are its params, defaults and ranges.
| Op | Params (default, range) | Animatable |
|---|---|---|
exposure | exposure 0 (in stops, −20 to 20; one stop doubles the light), offset 0 (−2 to 2), gamma 1 (0.1 to 9.99; more than 1 brightens) | all |
brightness-contrast | brightness 0 (−150 to 150), contrast 0 (−100 to 100), legacy off | on (the old straight version, which can clip) | brightness, contrast |
hue-saturation | hue 0 (−180 to 180 degrees), saturation 0 (−100 to 100; −100 = grey), vibrance 0 (−100 to 100; changes dull colours most, and runs first), lightness 0 (−100 = black, 100 = white) | all |
levels | inBlack 0, inWhite 255, gamma 1 (0.1 to 10), outBlack 0, outWhite 255. Values are 0 to 255. The same five exist per channel, with red, green or blue in front, for example redGamma. Each channel's levels run first, then the main levels. | all |
curves | master, red, green, blue, each "0,0 255,255". A curve is a list of x,y points from 0 to 255, at least two, with spaces between them. The red, green and blue curves run before master. | — |
color-balance | shadowRed, shadowGreen, shadowBlue, midtoneRed … highlightBlue: nine params, each 0 (−100 to 100). preserveLuminosity off | on keeps each pixel's brightness. | the nine balances |
temperature-tint | temperature 0 (−100 cooler and bluer, 100 warmer), tint 0 (−100 greener, 100 more magenta) | both |
invert | channel rgb (default) | red | green | blue, blend 0 (0 to 100 %: how much of the original comes back) | blend |
lut | file: a .cube file under assets/ (1D or 3D, Adobe or Resolve format). strength 1 (0 to 1). | strength |
- Starlight joins all of a layer's colour ops into one colour table (a LUT). It runs before the other effects. The colour ops run in their list order.
- In Properties, the colour ops sit in a color group at the top of the effects section. ↑ and ↓ move a colour op only among the colour ops.
- The ranges are the ranges of the Properties fields. They match After Effects. An op may cut a YAML value that is outside its range.
curveshas its own curve editor on its card, andluthas a file picker (Fonts, media and LUT files).- When Claude writes a scene, Starlight refuses a bad curve, an unknown colour param or a wrong choice, and names the param.
effects:
- curves: { master: "0,0 64,52 192,206 255,255" } # an S curve
- levels: { inBlack: 16, inWhite: 235, redGamma: 0.95 }
- lut: { file: assets/luts/film.cube, strength: 0.8 }
Particles
A particles layer is a particle system: sparks, dust, snow, embers, confetti or stars. It makes many small sprites, each with its own path, and draws them all in one fast step.
Brand kit & tokens
The brand kit holds the project's colours and fonts. A token is a named colour, like $team.gold . Change it once, and every layer that uses it changes.