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| Key | Description | Default | Accepted values |
|---|---|---|---|
sensitivity | Bar height multiplier. | 1.0 | 0.1..10 |
auto_sensitivity | Adjusts the height so loud passages just reach the top. | true | true, false |
low_cutoff_hz | Lowest frequency shown. | 50 | 20..20000 |
high_cutoff_hz | Highest frequency shown. Must be at least twice low_cutoff_hz. | 10000 | 40..48000 |
smoothing | How calmly the bars move. 0 follows the audio exactly. | 0.7 | 0.0..0.95 |
Tuning guidance:
- bars too short or too tall with
auto_sensitivity = false: changesensitivity - nervous, flickering bars: raise
smoothing, for example0.8 - sluggish bars: lower
smoothing, for example0.5 - bass on one side instead of in the middle: set
bar_orderto"low_to_high" - more bass detail: lower
high_cutoff_hzso 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| Key | Description | Default | Accepted values |
|---|---|---|---|
threshold | Audio peak level that counts as playing. | 0.035 | 0.0..1.0 |
activate_delay_ms | Audio must stay above the threshold this long before the visualizer appears. | 180 | integer milliseconds |
deactivate_delay_ms | Audio must stay below the threshold this long before the visualizer fades out. | 2200 | integer 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.