Skip to content

Module: PulseAudio

DreamMaoMao edited this page Aug 29, 2026 · 1 revision

Module: PulseAudio

Shows the PulseAudio volume (the "volume" module, with ALSA fallback), mute state and Bluetooth marker. Updates immediately on external changes via PulseAudio events.

"modules-right": ["pulseaudio"],

"pulseaudio": {
    "format": "{icon} {volume}% {bt}",
    "format-muted": " {volume}% {bt}",
    "icons": ["", "", "", "", "", "", "", ""],
    "icon-bluetooth": "󰂯",
    "on-click": "pamixer -t",
    "on-scroll-up": "pamixer -i 2",
    "on-scroll-down": "pamixer -d 2"
}

Options

Option Type Default Description
format string Normal format (see placeholders)
format-muted string Format used while muted
icons string array Icons shown by volume level
icon-muted string Icon used when muted
icon-bluetooth string Bluetooth marker shown when the active sink is a BT device

Placeholders

Placeholder Description
{} / {volume} / {percent} Volume percent
{icon} Icon selected from the icons array by level
{bt} / {bluetooth} Bluetooth marker (empty when not a BT sink)

Styling

#volume {
    background: linear-gradient(to top, #e3ac2b, mix(#e3ac2b, #fbf1c7, 0.3));
    color: #1b1a1a;
}

Clone this wiki locally