yambar-modules-alsa - Man Page

Monitors an alsa soundcard for volume and mute/unmute changes

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

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").

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

2025-07-25