A stereo LED matrix visualizer for cliamp - bars burst outward from a centered divider in classic green / yellow / red tiers, with peak-hold dots that hang briefly before decaying. Sibling of block-burst, vu-meter, and reverb.
cliamp plugins install AlexZeitler/cliamp-plugin-led-burstThen start cliamp and press v to cycle visualizers until led-burst appears.
To pin a specific version:
cliamp plugins install AlexZeitler/cliamp-plugin-led-burst@v0.1.0Remove with:
cliamp plugins remove led-burstThe plugin is a single Lua file. Edit ~/.config/cliamp/plugins/led-burst.lua after installing if you want to customize:
| What | Where | Effect |
|---|---|---|
| Color thresholds | tierColor() |
Where green flips to yellow, yellow to orange, orange to red. Values are normalized distance from center (0..1). |
| LED glyphs | LED_ON, LED_OFF, PEAK |
Try ●/·, ▮/▯, or █/ for different looks. |
| Spacing | GAP |
" " for the standard matrix gap, " " for an airier layout, "" for a solid bar. |
| Density | nLeds = math.floor((cols - 3) / 4) |
Lower the divisor (/ 3) for a denser matrix, raise (/ 5) for sparser. |
| Peak hold | (frame - (peakFrame[row] or 0)) > 6 |
Number of frames the peak hangs before decaying. |
| Peak decay | pk - 0.035 |
Per-frame decay rate after the hold expires. |
cliamp gives Lua visualizer plugins a bands table of 10 mono spectrum values (0.0 to 1.0) per frame, plus the current frame counter and the panel dimensions. led-burst spreads those 10 bands evenly across the available rows and, for each row, renders an LED bar growing outward from the center divider on both sides. The horizontal position of each cell within its half determines its color tier, and a per-row peak tracker draws a single marker at the highest point reached, decaying slowly back down.
The visualization is symmetric (left and right halves mirror) because Lua plugins don't have access to separate L/R channels - the mirroring is decorative, not stereo.
- cliamp with Lua plugin support
- A terminal with 256-color ANSI support (effectively every modern terminal)
- AlexZeitler/cliamp-plugin-block-burst - Nested LED pyramid where each tier responds to a different frequency range.
- AlexZeitler/cliamp-plugin-vu-meter - Ten analog-needle VU meters, one per spectrum band, drawn with sub-pixel braille.
- AlexZeitler/cliamp-plugin-reverb - Horizontal LED matrix inspired by vintage HiFi reverberation graphic displays, with quad-symmetric bars pulsing outward.
MIT - see LICENSE.