Skip to content

Docs / Using arts

Options reference

Every art takes the same settings. Set them on the art's page, name them in your request ("make it amber and slower"), or pass them to get_art.

Look and motion

SettingDefaultRangeWhat it does
color#A6E22Ehex colourColour of the lit dots
color2nonehex colourColour of the dimmest dots; brightness blends from it to color
backgroundtransparenthex colourFills the area behind the dots
gridonon or offA faint ring at every dot position
speed10 to 30 holds the art still
spacing84 to 20Pixels between dots; smaller is denser
size10.4 to 2Dot size
shaperoundround, squareDot shape
autoSpacingon in the library and in code from get_arton or offUnder 360 px, draws dots closer (down to 3 px) so small arts keep their shape. See Sizing

Values outside a range are moved to the nearest end of it. Colours are hex, such as #ff7a00 or #f70.

Settings for one art

SettingArtDefaultWhat it does
textMarqueeHELLO WORLDThe text that scrolls, up to 80 characters
fromCountdown10The number it counts down from, 1 to 99
hour12Clockoff12-hour time with AM and PM

Changing settings in your project

The file your assistant adds takes the same settings as properties, so later changes are a one-line request: "set the radar's speed to 0.6".