alsa.md

   1 [<- widgets](https://github.com/copycat-killer/lain/wiki/Widgets)
   2
   3 Shows and controls alsa volume with a textbox.
   4
   5         volume = lain.widgets.alsa()
   6
   7 ### input table
   8
   9 Variable | Meaning | Type | Default
  10 --- | --- | --- | ---
  11 `timeout` | Refresh timeout seconds | int | 5
  12 `channel` | Mixer channel | string | "Master"
  13 `settings` | User settings | function | empty function
  14
  15 `settings` can be fed with the following variables:
  16
  17 Variable | Meaning | Type | Values
  18 --- | --- | --- | ---
  19 volume.level | Self explained | int | 0-100
  20 volume.status | Device status | string | "on", "off"
  21
  22 ### output table
  23
  24 Variable | Meaning | Type
  25 --- | --- | ---
  26 `widget` | The widget | `wibox.widget.textbox`
  27 `notify` | Force update `widget` | function
  28
  29 You can control the widget with key bindings like these:
  30
  31     -- Volume control
  32     awful.key({ altkey }, "Up",
  33     function ()
  34         awful.util.spawn("amixer sset Master 1%+")
  35         volume.notify()
  36     end),
  37     awful.key({ altkey }, "Down",
  38     function ()
  39         awful.util.spawn("amixer sset Master 1%-")
  40         volume.notify()
  41     end),
  42     awful.key({ altkey }, "m",
  43     function ()
  44         awful.util.spawn("amixer set Master playback toggle")
  45         volume.notify()
  46     end),
  47     awful.key({ altkey, "Control" }, "m",
  48     function ()
  49         awful.util.spawn("amixer set Master playback 100%", false )
  50         volume.notify()
  51     end),
  52
  53 where `altkey = "Mod1"`.