Skip to Content
Kwybars
Configuration

Audio and Activity

How sound becomes bar heights, and when the visualizer shows and hides.

[audio]

Kwybars listens to whatever plays on your default output through PipeWire. If you switch the default output, it follows. There is nothing to choose or install; [audio] only tunes how the sound becomes bar heights.

[audio]
sensitivity = 1.0
auto_sensitivity = true
low_cutoff_hz = 50
high_cutoff_hz = 10000
smoothing = 0.7
KeyDescriptionDefaultAccepted values
sensitivityBar height multiplier.1.00.1..10
auto_sensitivityAdjusts the height so loud passages just reach the top.truetrue, false
low_cutoff_hzLowest frequency shown.5020..20000
high_cutoff_hzHighest frequency shown. Must be at least twice low_cutoff_hz.1000040..48000
smoothingHow calmly the bars move. 0 follows the audio exactly.0.70.0..0.95

Tuning guidance:

  • bars too short or too tall with auto_sensitivity = false: change sensitivity
  • nervous, flickering bars: raise smoothing, for example 0.8
  • sluggish bars: lower smoothing, for example 0.5
  • bass on one side instead of in the middle: set bar_order to "low_to_high"
  • more bass detail: lower high_cutoff_hz so the low range spreads over more bars

[activity]

Kwybars shows the visualizer while audio plays and hides it during silence. While hidden it draws nothing and uses no CPU.

[activity]
threshold = 0.035
activate_delay_ms = 180
deactivate_delay_ms = 2200
KeyDescriptionDefaultAccepted values
thresholdAudio peak level that counts as playing.0.0350.0..1.0
activate_delay_msAudio must stay above the threshold this long before the visualizer appears.180integer milliseconds
deactivate_delay_msAudio must stay below the threshold this long before the visualizer fades out.2200integer milliseconds

The fades themselves are set by fade_in_ms and fade_out_ms in [overlay].

If the visualizer disappears during quiet music, lower threshold. Set it to 0 to keep the visualizer on screen all the time.

On this page