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)