Skip to Content
Kwybars
Configuration

Layouts

Options for the line, mirror, wave, frame, radial, polygon, particle, and floating layouts.

Set the layout with layout in [visualizer]. Every layout also uses the keys on Visualizer.

Line

Use line for the standard edge-aligned bar layout. See the Line presets.

[visualizer]
layout = "line"
line_mode = "continuous"
KeyDescriptionDefaultAccepted values
line_modeNormal continuous line or split line with a center gap."continuous""continuous", "split"
line_split_gapCenter gap when line_mode = "split".200integer pixels

Split example:

[visualizer]
layout = "line"
line_mode = "split"
line_split_gap = 220

Mirror

Use mirror for centered mirrored bars. horizontal mirrors bars above and below a center axis; vertical mirrors them left and right. See the Mirror presets.

[visualizer]
layout = "mirror"
mirror_orientation = "horizontal"
mirror_gap = 24
KeyDescriptionDefaultAccepted values
mirror_orientationMirror axis direction."horizontal""horizontal", "vertical"
mirror_gapEmpty space between mirrored halves.0integer pixels
line_modeCan also split the mirrored distribution."continuous""continuous", "split"
line_split_gapCenter split gap when line_mode = "split".200integer pixels
center_offset_xHorizontal offset from monitor center.0pixels, positive moves right
center_offset_yVertical offset from monitor center.0pixels, positive moves down

Wave

Use wave for a continuous smoothed line. It sits on the edge set by position, like line. See the Wave presets.

[visualizer]
layout = "wave"
wave_stroke_width = 10
wave_fill = true
wave_glow = false
wave_smoothing = 1.0
wave_motion_smoothing = 0.22
wave_amplitude = 0.8
KeyDescriptionDefaultAccepted values
wave_stroke_widthWave line thickness.10integer pixels, minimum 1
wave_fillDraws a low-opacity fill under the wave.truetrue, false
wave_glowDraws a soft glow behind the wave line.falsetrue, false
wave_smoothingCurve smoothing factor.1.0number, 0 is sharper
wave_motion_smoothingHow quickly the wave follows the audio.0.22number, lower is softer and slower, 0 does not move
wave_amplitudeOverall wave height multiplier.0.8number, higher is taller

Frame

Use frame to draw bars on multiple edges in one monitor-sized overlay. See the Frame presets.

[visualizer]
layout = "frame"
frame_edges = ["top", "bottom", "left", "right"]
frame_mirror_mode = "pairs"
KeyDescriptionDefaultAccepted values
frame_edgesEdges to render on.["top", "bottom"]array using "top", "bottom", "left", "right"
frame_mirror_modeHow bars are distributed across active edges."pairs""off", "all", "pairs"

frame_mirror_mode = "off" distributes bars across selected edges. "all" mirrors the full bar set on every selected edge. "pairs" mirrors top+bottom together and left+right together.

Radial

Use radial for a circular or arc-shaped visualizer centered in a monitor-sized overlay. See the Radial presets.

[visualizer]
layout = "radial"
radial_inner_radius = 180
radial_start_angle = -90
radial_arc_degrees = 360
radial_rotation_speed = 0
KeyDescriptionDefaultAccepted values
radial_inner_radiusWhere radial bars start before growing outward.180integer pixels, minimum 1
radial_start_angleStart angle in degrees.-90number
radial_arc_degreesArc span. 360 is a full ring, 180 is a half circle.360number
radial_rotation_speedRotation speed in degrees per second.0number, negative reverses direction
center_offset_xHorizontal offset from monitor center.0pixels, positive moves right
center_offset_yVertical offset from monitor center.0pixels, positive moves down

Half-circle example:

[visualizer]
layout = "radial"
radial_inner_radius = 160
radial_start_angle = -180
radial_arc_degrees = 180

Polygon

Use polygon to place bars around a regular polygon such as a triangle, square, or hexagon. See the Polygon presets.

[visualizer]
layout = "polygon"
polygon_sides = 3
polygon_radius = 220
polygon_bar_length = 0
polygon_rotation = -90
polygon_rotation_speed = 0
KeyDescriptionDefaultAccepted values
polygon_sidesNumber of polygon sides.3integer, minimum 3
polygon_radiusOuter polygon radius.220integer pixels, minimum 1
polygon_bar_lengthMaximum outward bar length. 0 keeps automatic sizing.0integer pixels
polygon_rotationStatic polygon rotation in degrees.-90number
polygon_rotation_speedRotation speed in degrees per second.0number, negative reverses direction
center_offset_xHorizontal offset from monitor center.0pixels, positive moves right
center_offset_yVertical offset from monitor center.0pixels, positive moves down

Triangle example:

[visualizer]
layout = "polygon"
polygon_sides = 3
polygon_radius = 220
polygon_rotation = -90
polygon_rotation_speed = 18

Particle and Floating

particle and floating sit on the edge set by position, like line. See the Particle and Floating presets.

[visualizer]
layout = "particle"
bars = 10
bar_width = 40
gap = 10
[visualizer]
layout = "floating"
bars = 10
bar_width = 40
gap = 10

On this page