lain/alsa.md

[<- widgets](https://github.com/copycat-killer/lain/wiki/Widgets)

Shows and controls alsa volume with a textbox.

	volume = lain.widgets.alsa()

### input table

Variable | Meaning | Type | Default
--- | --- | --- | ---
`timeout` | Refresh timeout seconds | int | 5
`channel` | Mixer channel | string | "Master" 
`settings` | User settings | function | empty function

`settings` can use the following variables:

Variable | Meaning | Type | Values
--- | --- | --- | ---
volume.level | Self explained | int | 0-100
volume.status | Device status | string | "on", "off"

### output table

Variable | Meaning | Type
--- | --- | --- 
`widget` | The widget | `wibox.widget.textbox`
`update` | Update `widget` | function

You can control the widget with key bindings like these:

    -- Volume control
    awful.key({ altkey }, "Up",
    function ()
        awful.util.spawn("amixer set Master 1%+")
        volume.update()
    end),
    awful.key({ altkey }, "Down",
    function ()
        awful.util.spawn("amixer set Master 1%-")
        volume.update()
    end),
    awful.key({ altkey }, "m",
    function ()
        awful.util.spawn("amixer set Master playback toggle")
        volume.update()
    end),
    awful.key({ altkey, "Control" }, "m", 
    function ()
        awful.util.spawn("amixer set Master playback 100%", false )
        volume.update()
    end),

where `altkey = "Mod1"`.