+[<- widgets](https://github.com/copycat-killer/lain/wiki/Widgets)
+
Shows and controls alsa volume with a textbox.
myvolume = lain.widgets.alsa()
`header` | Text to show before value | string | " Vol "
`header_color` | Header color | string | `beautiful.fg_normal` or "#FFFFFF"
`color` | Value color | string | `beautiful.fg_focus` or "#FFFFFF"
+`footer` | Text to append after value | string | ""
+
+*Note*: `footer` can be markup text.
-and outputs the following table:
+`lain.widgets.alsa` outputs the following table:
Variable | Meaning | Type
--- | --- | ---
`widget` | The widget | `wibox.widget.textbox`
`channel` | Alsa channel | string
`step` | Increase/decrease step | string
-`notify` | The notification | function
+`notify` | Update `widget` | function
Finally, you can control the widget with key bindings like these:
- -- Volume control
- awful.key({ altkey }, "Up",
- function ()
- awful.util.spawn("amixer sset " .. volume.channel .. " " .. volume.step .. "+")
- volume.notify()
- end),
- awful.key({ altkey }, "Down",
- function ()
- awful.util.spawn("amixer sset " .. volume.channel .. " " .. volume.step .. "-")
- volume.notify()
- end),
- awful.key({ altkey }, "m",
- function ()
- awful.util.spawn("amixer set Master playback toggle")
- volume.notify()
- end),
- awful.key({ altkey, "Control" }, "m",
- function ()
- awful.util.spawn("amixer set Master playback 100%", false )
- volume.notify()
- end),
+ -- Volume control
+ awful.key({ altkey }, "Up",
+ function ()
+ awful.util.spawn("amixer sset " .. volume.channel .. " " .. volume.step .. "+")
+ volume.notify()
+ end),
+ awful.key({ altkey }, "Down",
+ function ()
+ awful.util.spawn("amixer sset " .. volume.channel .. " " .. volume.step .. "-")
+ volume.notify()
+ end),
+ awful.key({ altkey }, "m",
+ function ()
+ awful.util.spawn("amixer set Master playback toggle")
+ volume.notify()
+ end),
+ awful.key({ altkey, "Control" }, "m",
+ function ()
+ awful.util.spawn("amixer set Master playback 100%", false )
+ volume.notify()
+ end),
where `altkey = "Mod1"`.
\ No newline at end of file