yambar-modules-alsa(5)

🌸 NAME 🌸

Okay bestie, welcome to the yambar-modules-alsa(5) page — it lives in the File Formats Manual, and it's here to explain the alsa module. 💖

alsa — Monitors an alsa soundcard for volume and mute/unmute changes.

---

✨ TAGS ✨

Here's the tag lineup, and every single one is lowkey essential:

• online — bool — True when the ALSA device has successfully been opened.
• dB — range — Volume level (in dB), with min and max as start and end range values.
• volume — range — Volume level (raw), with min and max as start and end range values.
• percent — range — Volume level, as a percentage. This value is based on the dB tag if available, otherwise the volume tag.
• muted — bool — True if muted, otherwise false.

---

🎀 CONFIGURATION 🎀

This is the config situation, fr fr — every field, every requirement, no skipped details:

• card — string — Req: yes — The soundcard name. default might work.
• mixer — string — Req: yes — Mixer channel to monitor. Master might work.
• volume — string — Req: no — The name of the channel to use as source for the volume level (default: first available channel, usually "Front Left").
• muted — string — Req: no — The name of the channel to use as source for the muted state (default: first available channel, usually "Front Left").

---

🦋 EXAMPLES 🦋

This example is giving main character bar energy:

           bar:
             left:
               - alsa:
                   card: hw:PCH
                   mixer: Master
                   content: {string: {text: "{volume}"}}

---

🌈 SEE ALSO 🌈

Go peek at these too, iykyk:

• yambar-modules(5)
• yambar-particles(5)
• yambar-tags(5)
• yambar-decorations(5)

---

That's the whole page, bestie — no skipped tags, no missing config fields, we ate. 🫶 Footer source/version and date, as promised: manual name yambar-modules-alsa(5), date 2024-04-22. Now go give your soundcard main character energy. 💅✨