SFWBAR-ALSA(1)

NAME
sfwbar-alsa - Sfwbar ALSA module

Filename: alsactl.so

Requires: libasound

SYNOPSIS

The ALSA module provides an interface to query and adjust the settings of the ALSA sound system.

EXPRESSION FUNCTIONS

  Alsa(Query[,Element])

function Alsa queries the state of the ALSA system, the Query parameter specifies the information to query, the optional Element parameter specifies the mixer element to which the query applies. If the Element isn't given the query is applied to the "Master" element or the current card. The supported query types are:

    "playback-volume"
        the volume of a sink.

    "playback-mute"
        muted state of the sink.

    "capture-volume"
        the volume of a source.

    "capture-mute"
        muted state of the source.

ACTIONS

  AlsaCmd [Interface,],Command

Manipulate the state of the interface, if the interface isn't specified, the Command will be applied to the current interface.

    "playback-volume +/-X"
        Adjust the playback volume by X%. If the value isn't prefixed by either + or -, the volume is set to the percentage value X.

    "playback-mute State"
        Change the playback mute state, State can be On, Off or Toggle.

    "capture-volume +/-X"
        Adjust the capture volume by X%. If the value isn't prefixed by either + or -, the volume is set to the percentage value X.

    "capture-mute State"
        Change the capture mute state, State can be On, Off or Toggle.

  AlsaSetCard Card

Select ALSA sound card. This action accepts one paramter with a card name, by default the module will use "default" card.

TRIGGERS

The module defines one trigger "Alsa" which is emitted whenever the state of the ALSA system changes.

COPYRIGHT
GPLv3+