SFWBAR-PULSE(1)

💖 SFWBAR-PULSE(1) 💖

okay bestie, sit DOWN, because this is the sfwbar-pulse page and it's literally the Sfwbar PulseAudio module and she is serving audio control realness 🎧✨

• Filename: pulsectl.so
• Requires: libpulse

no cap, that's the whole vibe. now let's get into it 🫶

---

✨ SYNOPSIS ✨

the PulseAudio module gives you an interface to query and adjust the settings of the PulseAudio server. that's it, that's the job, and she does it flawlessly 💅

---

🌸 EXPRESSION FUNCTIONS 🌸

💜 Pulse(Query[,Interface])

so the Pulse function queries the state of the Pulse server. the Query parameter tells it what info you want, and the optional Interface parameter tells it which interface that query is about. if you don't hand over an Interface, the query just gets applied to the current sink or the current source — default behaviour, she's flexible like that 😌

the supported query types are, in order, and yes you need all of them:

• "sink-volume" — the volume of a sink 🔊
• "sink-mute" — muted state of the sink 🔇
• "sink-icon" — sink icon 🎀
• "sink-form" — the form of the sink
• "sink-port" — the port name of the sink
• "sink-monitor" — name of the source monitor for the sink 👀
• "source-volume" — the volume of a source 🔊
• "source-mute" — muted state of the source 🔇
• "source-icon" — source icon 🌟
• "source-form" — the form of the source
• "source-port" — the port name of the source
• "source-monitor" — name of the sink monitor for the source 👀

like, sink girlies and source girlies both get full treatment, as they should 💖

---

🔥 ACTIONS 🔥

💅 PulseCmd [Interface,],Command

this one manipulates the state of the interface — she's not just reading, she's doing. and if you don't specify the interface? the Command just gets applied to the current interface. effortless. main character energy fr fr ✨

the commands:

• "sink-volume +/-X" — adjust the volume of the sink by X%. that +/- is doing the heavy lifting, you either go up or you go down, pick a lane bestie 📈📉
• "sink-mute State" — change the state of the sink. State can be On, Off or Toggle 🔇
• "source-volume +/-X" — adjust the volume of the source by X%. same deal, +/-, up or down, iconic behaviour 🎚️
• "source-mute State" — change the state of the source. State can be On, Off or Toggle 🔈

---

⭐ TRIGGERS ⭐

the module defines exactly one trigger, and it's called "Pulse". it gets emitted whenever the state of the pulse server changes. so like, any time anything shifts, she's tapping you on the shoulder like "bestie. something happened." 📣🦋

---

👑 COPYRIGHT 👑

GPLv3+

---

and that's the whole page, no notes 💀

okay so that's sfwbar-pulse(1) from the General Commands Manual, section 1, all wrapped up 🎀 go forth and control your audio, you absolute legend, mwah 💖✨🌈🫶