cliamp-plugin-led-burst

KO | EN

gitlite — search

#javascript #react #ai #typescript #llm #golang #linux #docker #java #windows #cli #vue #mcp #openai

cliamp-plugin-led-burst

(★ 9)

A stereo LED matrix visualizer for cliamp

cliamp-plugin-led-burst Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# cliamp-plugin-led-burst

![led-burst visualizer in cliamp](https://raw.githubusercontent.com/AlexZeitler/cliamp-plugin-led-burst/master/assets/preview.png)

A stereo LED matrix visualizer for [cliamp](https://cliamp.stream) - 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](https://github.com/AlexZeitler/cliamp-plugin-block-burst), [vu-meter](https://github.com/AlexZeitler/cliamp-plugin-vu-meter), and [reverb](https://github.com/AlexZeitler/cliamp-plugin-reverb).

## Install

```sh
cliamp plugins install AlexZeitler/cliamp-plugin-led-burst
```

Then start cliamp and press `v` to cycle visualizers until `led-burst` appears.

To pin a specific version:

```sh
cliamp plugins install AlexZeitler/cliamp-plugin-led-burst@v0.1.0
```

Remove with:

```sh
cliamp plugins remove led-burst
```

## Tuning

The 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. |

## How it works

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.

## Requirements

- cliamp with Lua plugin support
- A terminal with 256-color ANSI support (effectively every modern terminal)

## Related plugins

- [AlexZeitler/cliamp-plugin-block-burst](https://github.com/AlexZeitler/cliamp-plugin-block-burst) - Nested LED pyramid where each tier responds to a different frequency range.
- [AlexZeitler/cliamp-plugin-vu-meter](https://github.com/AlexZeitler/cliamp-plugin-vu-meter) - Ten analog-needle VU meters, one per spectrum band, drawn with sub-pixel braille.
- [AlexZeitler/cliamp-plugin-reverb](https://github.com/AlexZeitler/cliamp-plugin-reverb) - Horizontal LED matrix inspired by vintage HiFi reverberation graphic displays, with quad-symmetric bars pulsing outward.

## License

MIT - see [LICENSE](LICENSE).

cliamp-plugin-led-burst

cliamp-plugin-led-burst Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

cliamp-plugin-led-burst

cliamp-plugin-led-burst Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README