Animations
An animation is one lighting mode — a look the strip shows. You pick a mode, and a few shared controls (brightness, speed, color, direction) tune how it looks. Everything you choose is saved, so the strip comes back the same after a power cut.
| Mode | What it looks like |
|---|---|
off | Fades the strip smoothly down to black, then stays off. |
white | Solid white. |
static | A solid color of your choosing (see Color). Fades in from one end when you switch to it. |
blink | Your chosen color flashing on and off. Speed controls how fast it blinks. |
rainbow | A rainbow that scrolls along the strip. Its speed and direction are adjustable, and it works with segmenting. |
runner | A short trail of light that chases along the strip, brightest in the middle and fading at the ends. |
Shared controls
Section titled “Shared controls”These apply across modes and are set together with the mode (over MQTT, or cycled with the button):
Brightness
Section titled “Brightness”brightness runs from 1 to 100 — a simple percentage of full brightness.
100 is as bright as the strip goes; lower values dim everything evenly.
speed also runs from 1 to 100, and controls how fast the animated modes
move. It affects rainbow, runner, and blink; white and static ignore
it.
| Mode | What speed feels like |
|---|---|
runner | How fast the trail travels. 10 takes about 14 seconds to go once around a 144-LED strip; 100 sweeps it in under 2 seconds. |
rainbow | How fast the rainbow scrolls. 10 is roughly one full color cycle per second; 100 is strobe-fast. |
blink | How fast it flashes. 10 blinks a little slower than once a second; 100 blinks five times a second. |
Comfortable everyday values are around 5–20.
color is a single [red, green, blue] value (each 0–255) used by the
color-driven modes — static fills the strip with it, blink flashes it, and
runner’s trail takes it. white and rainbow ignore it.
Direction
Section titled “Direction”direction is either "forward" or "backward". "backward" mirrors the
strip so animations play from the far end instead of the near end. It affects
every mode except off.
Segmenting
Section titled “Segmenting”Segmenting splits the strip into repeating blocks, so a pattern repeats every
few LEDs instead of stretching across the whole strip once. Configure it under
leds.segmenting:
"segmenting": {"enabled": true, "length": 5}enabledturns it on;lengthis how many LEDs each repeat spans (minimum 2).- It only affects modes that repeat sensibly — mainly
rainbow. Solid fills and the single running trail always use the whole strip. - If
lengthends up as large as the strip, the whole strip is treated as one block (no repeat).