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"| Key | Description | Default | Accepted values |
|---|---|---|---|
line_mode | Normal continuous line or split line with a center gap. | "continuous" | "continuous", "split" |
line_split_gap | Center gap when line_mode = "split". | 200 | integer pixels |
Split example:
[visualizer]
layout = "line"
line_mode = "split"
line_split_gap = 220Mirror
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| Key | Description | Default | Accepted values |
|---|---|---|---|
mirror_orientation | Mirror axis direction. | "horizontal" | "horizontal", "vertical" |
mirror_gap | Empty space between mirrored halves. | 0 | integer pixels |
line_mode | Can also split the mirrored distribution. | "continuous" | "continuous", "split" |
line_split_gap | Center split gap when line_mode = "split". | 200 | integer pixels |
center_offset_x | Horizontal offset from monitor center. | 0 | pixels, positive moves right |
center_offset_y | Vertical offset from monitor center. | 0 | pixels, 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| Key | Description | Default | Accepted values |
|---|---|---|---|
wave_stroke_width | Wave line thickness. | 10 | integer pixels, minimum 1 |
wave_fill | Draws a low-opacity fill under the wave. | true | true, false |
wave_glow | Draws a soft glow behind the wave line. | false | true, false |
wave_smoothing | Curve smoothing factor. | 1.0 | number, 0 is sharper |
wave_motion_smoothing | How quickly the wave follows the audio. | 0.22 | number, lower is softer and slower, 0 does not move |
wave_amplitude | Overall wave height multiplier. | 0.8 | number, 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"| Key | Description | Default | Accepted values |
|---|---|---|---|
frame_edges | Edges to render on. | ["top", "bottom"] | array using "top", "bottom", "left", "right" |
frame_mirror_mode | How 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| Key | Description | Default | Accepted values |
|---|---|---|---|
radial_inner_radius | Where radial bars start before growing outward. | 180 | integer pixels, minimum 1 |
radial_start_angle | Start angle in degrees. | -90 | number |
radial_arc_degrees | Arc span. 360 is a full ring, 180 is a half circle. | 360 | number |
radial_rotation_speed | Rotation speed in degrees per second. | 0 | number, negative reverses direction |
center_offset_x | Horizontal offset from monitor center. | 0 | pixels, positive moves right |
center_offset_y | Vertical offset from monitor center. | 0 | pixels, positive moves down |
Half-circle example:
[visualizer]
layout = "radial"
radial_inner_radius = 160
radial_start_angle = -180
radial_arc_degrees = 180Polygon
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| Key | Description | Default | Accepted values |
|---|---|---|---|
polygon_sides | Number of polygon sides. | 3 | integer, minimum 3 |
polygon_radius | Outer polygon radius. | 220 | integer pixels, minimum 1 |
polygon_bar_length | Maximum outward bar length. 0 keeps automatic sizing. | 0 | integer pixels |
polygon_rotation | Static polygon rotation in degrees. | -90 | number |
polygon_rotation_speed | Rotation speed in degrees per second. | 0 | number, negative reverses direction |
center_offset_x | Horizontal offset from monitor center. | 0 | pixels, positive moves right |
center_offset_y | Vertical offset from monitor center. | 0 | pixels, positive moves down |
Triangle example:
[visualizer]
layout = "polygon"
polygon_sides = 3
polygon_radius = 220
polygon_rotation = -90
polygon_rotation_speed = 18Particle 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