Configuration
Visualizer
Bar count, size, order, colors, and segmented bars.
[visualizer] controls how the bars look.
[visualizer]
layout = "line"
bars = 50
bar_width = 8
gap = 20
framerate = 60
color_mode = "gradient"
gradient_direction = "vertical"
color_rgba = "rgba(166, 227, 161, 0.82)"
color2_rgba = "rgba(137, 180, 250, 0.82)"| Key | Description | Default | Accepted values |
|---|---|---|---|
layout | Visualizer layout mode. | "line" | "line", "mirror", "wave", "frame", "radial", "polygon", "particle", "floating" |
grow_from | Which side the bars grow from, for line, wave, particle, and floating. "edge" is the screen edge set by position; "opposite" is the other side, so bars at the top of the screen grow upward. | "edge" | "edge", "opposite" |
bars | Number of bars or samples used by the layout. | 50 | integer, 1 to 1024 |
bar_order | Where the bass is along the bars. See Bar Order. | "bass_center" | "low_to_high", "bass_center", "bass_edges" |
bar_width | Base bar thickness. | 8 | integer pixels |
bar_corner_radius | Rounded corner radius. Effective value is clamped by bar size. | 20 | number, 0 for square bars |
gap | Space between bars. | 20 | integer pixels |
framerate | Highest redraw rate. Redraws follow your monitor and never exceed this. | 60 | integer, minimum 1 |
color_mode | How colors are applied. | "gradient" | "solid", "gradient" |
gradient_direction | vertical colors each bar along its length. horizontal spreads colors smoothly across the whole layout; theme colors blend instead of forming six blocks. | "vertical" | "vertical", "horizontal" |
color_rgba | Primary bar color. | "rgba(175, 198, 255, 0.7)" | RGBA string |
color2_rgba | Secondary color used by gradient mode. | "rgba(191, 198, 220, 0.7)" | RGBA string |
theme | Optional theme name, or a table of six colors. See Themes. | none | string or table |
theme_opacity | Alpha multiplier for theme colors. | 1.0 | 0.0..1.0 |
Bar Order
bar_order decides which frequencies each bar shows.
| Value | Result |
|---|---|
"low_to_high" | Bass on the first bar, treble on the last. On a bottom or top overlay, bass is on the left. |
"bass_center" | Bass in the middle, treble towards both ends. Both halves show the same sound, mirrored. |
"bass_edges" | Bass at both ends, treble in the middle. |
[visualizer]
bars = 60
bar_order = "low_to_high"With the two mirrored orders, each half uses half of the bars, so an even bars value gives two equal halves. It works with every layout.
Color Formats
color_rgba and color2_rgba accept CSS-like and comma-separated values:
color_rgba = "rgba(31, 224, 173, 0.90)"
color_rgba = "31,224,173,0.90"
color_rgba = "0.12,0.88,0.68,0.90"RGB values can be 0..255 or normalized 0..1. Alpha is always 0..1.
For colors.toml overrides and Matugen integration, see Colors and Matugen.
Segmented Bars
Segmented bars split each bar into repeated blocks.
[visualizer]
segmented_bars = true
segment_length = 14
segment_gap = 6| Key | Description | Default | Accepted values |
|---|---|---|---|
segmented_bars | Enables repeated block rendering. | false | true, false |
segment_length | Length of each segment along the growth direction. | 14 | integer pixels, minimum 1 |
segment_gap | Gap between segments. | 6 | integer pixels |