SFWBAR-ALSA(1)

💖 NAME 💖

okay so bestie, gather round: this is sfwbar-alsa, aka the Sfwbar ALSA module. it's the little guy that lets your bar talk to your sound system. no cap.

• Filename: alsactl.so
• Requires: libasound

so like, that's the file it lives in and the library it needs. noted. ✨

---

🌸 SYNOPSIS 🌸

the ALSA module is literally your backstage pass to the ALSA sound system — it gives you an interface to query and adjust its settings. that's the whole vibe. 🎀

---

✨ EXPRESSION FUNCTIONS ✨

🦋 Alsa(Query[,Element])

Alsa(Query[,Element])

Alsa is the function that goes and asks the ALSA system "hey girl what's your status". Query is the thing you wanna know, and the optional Element is the mixer element you want that query to apply to. if you don't pass an Element, the query just goes to the "Master" element, or to the current card. easy.

here's what you can ask for, the supported query types:

• "playback-volume" — the volume of a sink. 🔊
• "playback-mute" — the muted state of the sink. 🔇
• "capture-volume" — the volume of a source. 🎤
• "capture-mute" — the muted state of the source. 🤫

---

💅 ACTIONS 💅

👑 AlsaCmd [Interface,],Command

AlsaCmd [Interface,],Command

this one is for manipulating stuff, not just looking at it. it changes the state of the interface. and if you don't specify the interface? no worries, the Command just gets applied to the current interface. slay.

the commands, bestie:

• "playback-volume +/-X" — adjust the playback volume by X%. and listen: if that value isn't prefixed by either + or -, then the volume gets set to the percentage value X instead of nudged. so +10 means "turn it up by 10", but plain 10 means "make it 10". big difference, iykyk.
• "playback-mute State" — change the playback mute state. State can be On, Off or Toggle. 🎚️
• "capture-volume +/-X" — adjust the capture volume by X%. same deal as playback: if the value isn't prefixed by either + or -, the volume is set to the percentage value X.
• "capture-mute State" — change the capture mute state. State can be On, Off or Toggle.

🎀 AlsaSetCard Card

AlsaSetCard Card

pick your ALSA sound card, bestie. this action takes one parameter, and that parameter is a card name. and by default — like, if you don't say anything — the module just uses the "default" card. iconic behaviour honestly. 🌈

---

🔥 TRIGGERS 🔥

this module defines exactly one trigger, and it's called "Alsa". it gets emitted whenever the state of the ALSA system changes. so like, sound stuff moves → trigger fires. that's the whole thing. 🫶

---

💜 COPYRIGHT 💜

GPLv3+

---

and that's a wrap, angel! 💖 this little page came out of the General Commands Manual and it's all about sfwbar-alsa(1) — so go forth, control your volume, and be the main character of your own sound system. periodt. 🎀✨🦋