Skip to content

audio_visualizer

Horizontal audio spectrum using the current PipeWire monitor stream.

SettingTypeDefaultDescription
widthnumber56Widget width in screen pixels
bandsnumber16Number of spectrum bands; ignored when show_wave is enabled
mirroredbooltrueMirror the spectrum around the center line
centeredbooltrueCenter bars on the cross axis instead of aligning them to the edge; no effect when show_wave is enabled
show_waveboolfalseRender the spectrum as a smooth filled wave instead of discrete bars, with a smaller echo wave in color_2
show_when_idleboolfalseKeep the widget visible even when no media is playing
color_1string"primary"First gradient color role; fixed hex colors are also supported
color_2string"primary"Second gradient color role; fixed hex colors are also supported

The widget height fills the available bar space automatically.

[widget.audio-vis]
type = "audio_visualizer"
width = 64
bands = 20
centered = true
show_when_idle = true
color_1 = "primary"
color_2 = "secondary"