yambar-modules-alsa(5) File Formats Manual yambar-modules-alsa(5)

# [NAME](#NAME)

alsa - Monitors an alsa soundcard for volume and mute/unmute changes

# [TAGS](#TAGS)

**Name** **Type** **Description** 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](#CONFIGURATION)

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

# [EXAMPLES](#EXAMPLES)

```
bar:


  left:


    - alsa:


        card: hw:PCH


        mixer: Master


        content: {string: {text: "{volume}"}}
```

# [SEE ALSO](#SEE_ALSO)

[**yambar-modules**(5)](/man/enterprise-packages/yambar/yambar-modules.5), [**yambar-particles**(5)](/man/enterprise-packages/yambar/yambar-particles.5), [**yambar-tags**(5)](/man/enterprise-packages/yambar/yambar-tags.5), [**yambar-decorations**(5)](/man/enterprise-packages/yambar/yambar-decorations.5)

2026-10-30

---

Document: yambar-modules-alsa(5) from yambar 1.11.0-r5 (Chainguard OS)
Source: https://codeberg.org/dnkl/yambar