Skip to Content
Kwybars
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)"
KeyDescriptionDefaultAccepted values
layoutVisualizer layout mode."line""line", "mirror", "wave", "frame", "radial", "polygon", "particle", "floating"
grow_fromWhich 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"
barsNumber of bars or samples used by the layout.50integer, 1 to 1024
bar_orderWhere the bass is along the bars. See Bar Order."bass_center""low_to_high", "bass_center", "bass_edges"
bar_widthBase bar thickness.8integer pixels
bar_corner_radiusRounded corner radius. Effective value is clamped by bar size.20number, 0 for square bars
gapSpace between bars.20integer pixels
framerateHighest redraw rate. Redraws follow your monitor and never exceed this.60integer, minimum 1
color_modeHow colors are applied."gradient""solid", "gradient"
gradient_directionvertical 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_rgbaPrimary bar color."rgba(175, 198, 255, 0.7)"RGBA string
color2_rgbaSecondary color used by gradient mode."rgba(191, 198, 220, 0.7)"RGBA string
themeOptional theme name, or a table of six colors. See Themes.nonestring or table
theme_opacityAlpha multiplier for theme colors.1.00.0..1.0

Bar Order

bar_order decides which frequencies each bar shows.

ValueResult
"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
KeyDescriptionDefaultAccepted values
segmented_barsEnables repeated block rendering.falsetrue, false
segment_lengthLength of each segment along the growth direction.14integer pixels, minimum 1
segment_gapGap between segments.6integer pixels

On this page