waybar-pulseaudio-slider(5)

💖 waybar-pulseaudio-slider — the manual page, but make it bestie edition 💖

okay so this is the page for waybar-pulseaudio-slider(5), which lives under File Formats Manual and is literally just the waybar pulseaudio slider module. yes waybar, yes sliders, yes volume control that actually slaps. let's go 🎀

---

✨ NAME ✨

waybar — pulseaudio slider module 💅

---

🌸 DESCRIPTION 🌸

okay bestie, here's the tea: the pulseaudio slider module displays and controls the current volume of the default sink or source — and it does it as a bar. yes, a whole bar. iconic behavior honestly.

and the way you vibe with it? you drag the slider across the bar, or you just click on a specific position. that's it. that's the whole interaction model. so satisfying, no cap 🫶

---

🎀 CONFIGURATION 🎀

these are the knobs you get to turn. literally.

• min — typeof: int, default: 0. the minimum volume value the slider should display and set. it's giving "floor, but for volume" 💜
• max — typeof: int, default: 100. the maximum volume value the slider should display and set. the ceiling. the limit. the "bestie pls that's loud enough" 🍓
• orientation — typeof: string, default: horizontal. the orientation of the slider, and it can be either horizontal or vertical. pick your fighter ✨
• expand — typeof: bool, default: false. when it's on, this module gets to consume all left over space dynamically. main character energy fr fr, it just takes up whatever room is left 👑

---

🔥 EXAMPLES 🔥

here's what it looks like in your config, in all its glory:

    "modules-right": [
        "pulseaudio/slider",
    ],
    "pulseaudio/slider": {
        "min": 0,
        "max": 100,
        "orientation": "horizontal"
    }

look at it. min 0, max 100, orientation horizontal. it's a whole mood and it works 🌈

---

💅 STYLE 💅

so the slider is a component with multiple CSS Nodes, and the ones that are exposed to you are these little cuties:

• #pulseaudio-slider — controls the style of the box around the slider and bar. the whole container vibe 🫧
• #pulseaudio-slider slider — controls the style of the slider handle. you know, the thing you drag. the little guy 🎀
• #pulseaudio-slider trough — controls the style of the part of the bar that has not been filled. the empty zone. the before-fill 🕳️
• #pulseaudio-slider highlight — controls the style of the part of the bar that has been filled. the filled zone. the ate-and-left-no-crumbs part 🔥

✨ STYLE EXAMPLE ✨

copy-paste-able, verbatim, here you go bestie:

    #pulseaudio-slider slider {
        min-height: 0px;
        min-width: 0px;
        opacity: 0;
        background-image: none;
        border: none;
        box-shadow: none;
    }

    #pulseaudio-slider trough {
        min-height: 80px;
        min-width: 10px;
        border-radius: 5px;
        background: black;
    }

    #pulseaudio-slider highlight {
        min-width: 10px;
        border-radius: 5px;
        background: green;
    }

slay. trough is black, highlight is green, and the handle is fully invisible (opacity: 0, no border, no box-shadow, no background-image). that's the whole look. obsessed 💖

---

okay that's the whole page!! this version of waybar-pulseaudio-slider(5) was dated 2026-02-08 — like it was written in the future, which is highkey iconic of it — and yeah, that's the whole thing. go forth and slide, bestie 🦋💜👑