Attract Particles¶

The particles mode renders drifting firefly-like particles with independent motion, color cycling, and edge-wrapping behavior. The mode produces a calm ambient glow effect by filling the panel with small filled circles that move in independent directions at varying speeds, with hue cycling over time. Each particle's heading is perturbed every frame by a configurable drift randomness factor, and when a particle exits one panel edge it re-enters at a random position on the opposite edge, retaining its current color phase.

Options¶

Key	Type	Description	Default	Allowed Values
`speed`	float	Particle speed multiplier controlling how quickly individual firefly dots move across the panel	1.0	any valid float (0.1–10.0 recommended)
`density`	float	Particle count scaling factor from sparse (0.1) to maximum particle coverage (1.0)	0.5	any valid float (0.1–1.0)
`drift`	float	Random directional wander per frame controlling how erratically particles change heading each tick	0.3	any valid float (0.0–1.0)
`glow`	float	Hue cycling intensity controlling how rapidly particle colors shift through the rainbow spectrum	0.5	any valid float (0.1–1.0)

Policy Fields¶

Field	Type	Range	Default	Description
Speed	float64	[0.1, 10.0]	1.0	Particle speed multiplier
Density	float64	[0.1, 1.0]	0.5	Particle count scaling
Drift	float64	[0.0, 1.0]	0.3	Random directional wander per frame
Glow	float64	[0.1, 1.0]	0.5	Hue cycling intensity

CLI Examples¶

Query the current particles policy:

cyberhudctl display attract_particles

Set a faster speed with higher density and stronger drift:

cyberhudctl display config 0 speed=3.0 density=0.8 drift=0.7

Panel Compatibility¶

Color TFT — full-color rendering with smooth hue cycling across all particles. Each particle displays its current color phase as a filled circle with per-frame position updates.
Monochrome OLED — particles render as white filled circles on a black background. Hue cycling is not visible but motion, drift, and edge-wrapping behavior remain intact.
E-Ink — static particle scatter frame rendered for slow-refresh panels. See below.

E-Ink Behavior¶

On e-ink panels, the particles mode renders a static particle scatter frame for slow-refresh panels. Rather than animating continuously, a single frame is drawn with particles placed at their initial randomized positions. This avoids excessive refresh cycles that would degrade the e-ink display or produce visible flicker.