[<- widgets](https://github.com/copycat-killer/lain/wiki/Widgets)
-Shows and controls alsa volume with a progressbar.
-
-Dependencies:
-
-- alsa-utils (of course)
-
-Plus tooltips, notifications, and color changes at mute/unmute switch.
+Shows and controls alsa volume with a progressbar; provides tooltips, notifications, and color changes at mute/unmute switch.
myvolumebar = lain.widgets.alsabar()
Variable | Meaning | Type | Default
--- | --- | --- | ---
+`timeout` | Refresh timeout seconds | int | 4
`width` | Bar width | int | 63
`height` | Bar height | int | 1
`ticks` | Set bar ticks on | boolean | true
It's **crucial** to set `notifications.bar_size` to your `mywibox[s]` height,
**if** you have set it different than default (18).
-`lain.widgets.alsabar` outputs the following table:
+### output table
Variable | Meaning | Type
--- | --- | ---
`step` | Increase/decrease step | string
`notify` | The notification | function
-Finally, you can control the widget with key bindings like these:
+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 .. "+")
+ awful.util.spawn("amixer set " .. volume.channel .. " " .. volume.step .. "+")
volume.notify()
end),
awful.key({ altkey }, "Down",
function ()
- awful.util.spawn("amixer sset " .. volume.channel .. " " .. volume.step .. "-")
+ awful.util.spawn("amixer set " .. volume.channel .. " " .. volume.step .. "-")
volume.notify()
end),
awful.key({ altkey }, "m",