Raxol.Effects.BorderBeam.Effects.Clouds (Raxol v2.6.0)

View Source

A soft, non-directional shimmer along the entire perimeter.

Where :stroke is one bright comet sweeping clockwise, clouds is the opposite: every perimeter cell is lit at all times, but each one's intensity and color come from the sum of three sine waves at different frequencies and directions. The result is an interference pattern -- brightness rolls and pools rather than sweeping. No single direction reads as "forward."

No char replacement; only fg color and intensity. Reads as a calm, passive ambient state -- pairs well with :listening or :idle process indicators where motion would distract.

Surface support: terminal only. LiveView/MCP currently ignore non-stroke effect types.

Opts

  • :variant -- color palette (default :mono)
  • :duration_ms -- baseline period for the slowest wave (default 6000)
  • :strength -- 0.0-1.0 peak intensity (default 0.7)
  • :softness -- 0.0-1.0 how much intensity varies between cells (default 0.55; higher = more contrast between bright and dim spots)