Skip to content

Engine · v4.0.0

Kwanzaa

A warm Kwanzaa home scene: the kinara's seven candles light one by one through your song, beside the mkeka, the harvest and the unity cup.

Kwanzaa engine preview

6 modes

Launch modes

Kinara Light mode

Kinara Light

The kinara on the mkeka with the harvest and the unity cup: each section of the song lights the next candle in order, and every flame dances to its own part of the spectrum.

Seven Principles mode

Seven Principles

The seven candles stand alone, each with a column of light for its band, and can carry the name of the principle it honours.

Woven Bands mode

Woven Bands

A hanging cloth of original woven strips that lights up as a spectrum from its centre line, the weave rippling with the mids.

Harvest Table mode

Harvest Table

A calm close view of the harvest, the corn and the unity cup on the mkeka, lit by the kinara behind them. Made for spoken word and podcasts.

Unity Glow mode

Unity Glow

Seven rings of warm light around your cover art or the unity cup, one ring for each principle, lit through the song.

Community Rings mode

Community Rings

Circles of small lights around a kinara that join hands, light by light, as the song goes on.

36 controls

Controls

ControlGroupTypeDefaultAnimationAudio
Primary colorPrimary color used by the engine paletteStylecolor#e8b04aYesNo
Secondary colorSecondary color used by the engine paletteStylecolor#f08a3cYesNo
BackgroundBackground used by the engine paletteStylecolor#120b07YesNo
OpacityVisualizer opacityTransformrange1YesNo
SensitivityBounded overall audio responseAudiorange1YesNo
Spectrum rangeHow much of the 40 Hz to 14 kHz range the visual spans, from the bass up. Lower it to give the bass and mids more of the barsAudiorange1YesNo
Frequency scaleHow the bars are spread across the frequencies. Log spreads them by octave, mel by how pitch is heard, and linear by hertz, which gives most bars to the highsAudioselectlogNoNo
Auto-levelLifts every part of the spectrum to its own recent range, so quiet highs move as much as loud bass. A note held for several seconds settles lower as it adapts. 0 shows the raw spectrumAudiorange0.8YesNo
Primary audio sourcePrimary audio sourceAudioselectbassNoNo
Frequency focusWhich part of the spectrum drives this visual; while no explicit audio source is set, the motion envelope follows this selectionAudioselectfullNoNo
Burst intensityGlow and trail swell on sharp hits; 0 keeps bursts offAudiorange0YesNo
Ambient bedProminence of the standing background layer behind the beat-born elementsEffectsrange1YesNo
Wake lengthHow far motion trails stretch behind beat-born travelers; 0 removes the wakeEffectsrange1YesNo
Audio contributionMaximum contribution from the primary audio routeAudiorange0.55YesNo
Audio dynamicsHow much of the band's movement reaches the visual. 1 = full dynamics; 0 holds it at a steady level for a calmer, more constant lookAudiorange1YesNo
Audio attackEnvelope attack in millisecondsAudiorange45YesNo
Audio releaseEnvelope release in millisecondsAudiorange240YesNo
Geometry scaleGeometry scaleGeometryrange1YesYes
SpeedTime-based motion; default major cycle is 6–12 secondsMotionrange0.1YesYes
Color modeDuo palette, primary→secondary gradient, or full rainbow sweepStyleselectduoNoNo
GlowGlowEffectsrange0.55YesYes
Global glowShared emissive strength across the frameEffectsrange0.35YesYes
Pulse intensityBeat pulse scale for spawn, size, and shakeEffectsrange1YesYes
Beat responseHow hard every engine hits on each detected beatAudiorange1.2YesYes
Beat smoothingHow long each beat hit rings out before it settlesAudiorange0.35YesYes
Beat attackSeconds for a hit to swell to full. 0 snaps instantlyAudiorange0YesYes
Beat releaseSeconds for a hit to fade, overriding Beat smoothing. 0 follows itAudiorange0YesYes
Beat shakeFrame kick strength on each beatEffectsrange0.6YesYes
Motion echoMotion echoEffectsrange0YesYes
BlurBlurEffectsrange0YesYes
Chromatic aberrationChromatic aberrationEffectsrange0YesYes
Beat sync allRoute beat energy into spawn, shake, pulse, speed, and scaleAudiobooleantrueNoNo
Candles litFollow the song lights the next candle at each new section, in the kinara's lighting order. Pick a day to show that night's candles all the way throughKinaraselectsongNoNo
Principle labelsName the principle each candle stands for under it, in Swahili with the English meaningKinarabooleanfalseNoNo
GreetingAn optional line of your own under the title and artistTexttextNoNo
Cover artworkArtwork at the centre of the rings; without it the unity cup stands there (your logo is used when no cover is set)ArtworktextNoNo