NAME

       alsa - 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                                         │
       └────────┴───────┴────────────────────────────────────────────────────────────────────────┘

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

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

SEE ALSO

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

                                            2024-04-01                     yambar-modules-alsa(5)