waybar-pulseaudio(5)          File Formats Manual         waybar-pulseaudio(5)

<?><?><?> (NAME)
       waybar - <?><?><?><?><?> pulseaudio

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> pulseaudio <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> PulseAudio <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       format:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: {volume}%
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

       format-bluetooth:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       format-muted:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?> (muted)
       <?><?><?> <?><?><?><?>.

       format-source:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: {volume}%
       <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> (source)
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       format-source-muted:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> (source)
       <?><?><?><?><?><?> (muted) <?><?><?> <?><?><?><?>.

       format-icons:
       <?><?><?>: <?><?><?><?><?> (array)
       <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> (port) <?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?> <?><?> low
       (<?><?>) <?><?> high (<?><?><?><?>) <?><?><?>. <?><?><?>
       <?><?><?><?><?><?><?><?> (ICONS) <?><?> <?><?><?><?><?><?>.

       rotate:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> (<?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>).

       states:
       <?><?><?>: <?><?><?> (object)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>. <?><?>
       waybar-states(5) <?><?><?><?><?><?> <?><?><?><?>.

       max-length:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

       min-length:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       align:
       <?><?><?>: <?><?><?><?> <?><?><?><?><?> (float)
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> 0
       <?><?><?><?><?><?> <?> 1 <?><?><?><?><?><?><?><?> <?><?><?>. <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       justify:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?> 'left' (<?><?>)<?>
       'right' (<?><?><?><?>) <?><?> 'center' (<?><?><?>) <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.

       scroll-step:
       <?><?><?>: <?><?><?><?> <?><?><?><?><?> (float)
       <?><?><?><?><?><?><?>: 1.0
       <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       on-click:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       on-click-middle:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       (<?><?> <?><?><?> <?><?><?><?>) <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       on-click-right:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       on-update:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       on-scroll-up:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>.

       on-scroll-down:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?>.

       smooth-scrolling-threshold:
       <?><?><?>: <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> (double)
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       reverse-scrolling:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>.

       reverse-mouse-scrolling:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

       tooltip:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?>: true
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> (tooltip)
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?>.

       max-volume:
       <?><?><?>: <?><?><?> <?><?><?><?> (integer)
       <?><?><?><?><?><?><?>: 100
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?>.

       ignored-sinks:
       <?><?><?>: <?><?><?><?><?> (array)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> (sinks) <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> Waybar <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?>. <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> (description) <?><?><?><?><?>
       <?><?><?><?><?>.

       menu:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?>.

       menu-file:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           GtkMenu <?><?> <?><?><?><?><?> menu <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?>

       menu-actions:
       <?><?><?>: <?><?><?><?><?> (array)
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?>.

       expand:
       <?><?><?>: <?><?><?><?> (bool)
       <?><?><?><?><?><?><?>: false
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>.

<?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (FORMAT
       REPLACEMENTS)
       {desc}: <?><?><?><?><?><?><?> <?><?><?><?><?> (port) <?><?>
       PulseAudio<?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       {volume}: <?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?>.

       {icon}: <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       format-icons.

       {format_source}: <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       format-source<?> format-source-muted.

<?><?><?><?><?><?><?><?> (ICONS)
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> format-icons
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       o   <?><?><?> <?><?><?><?><?><?> (device name)

       <?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> PulseAudio <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?>.

       o   default (<?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?>)
       o   headphone
       o   speaker
       o   hdmi
       o   headset
       o   hands-free
       o   portable
       o   car
       o   hifi
       o   phone

       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       -muted <?><?> <?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?>. <?><?><?> <?><?><?><?> <?><?><?><?> default <?><?><?>
       <?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
           "pulseaudio": {
                "format": "{volume}% {icon}",
                "format-bluetooth": "{volume}% {icon}<?>",
                "format-muted": "<?>",
                "format-icons": {
                     "alsa_output.pci-0000_00_1f.3.analog-stereo": "<?>",
                     "alsa_output.pci-0000_00_1f.3.analog-stereo-muted": "<?><?>",
                     "headphone": "<?>",
                     "hands-free": "<?>",
                     "headset": "<?>",
                     "phone": "<?>",
                     "phone-muted": "<?>",
                     "portable": "<?>",
                     "car": "<?>",
                     "default": ["<?>", "<?>"]
                },
                "scroll-step": 1,
                "on-click": "pavucontrol"
           }

<?><?><?><?><?><?> (STYLE)
       o   #pulseaudio
       o   #pulseaudio.bluetooth
       o   #pulseaudio.muted

                                  2026-08-31              waybar-pulseaudio(5)