X-Git-Url: https://git.madduck.net/etc/awesome.git/blobdiff_plain/a9073b7f86fe7540bad749c5d035f43c7ddd183d..08b707a1589e2328dfa25e13026c63567f8404c5:/alsabar.md?ds=sidebyside diff --git a/alsabar.md b/alsabar.md index 9b5a711..ad5b1bf 100644 --- a/alsabar.md +++ b/alsabar.md @@ -1,12 +1,6 @@ [<- 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() @@ -18,6 +12,7 @@ The function takes a table as optional argument, which can contain: 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 @@ -48,7 +43,7 @@ Variable | Meaning | Type | Default 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 --- | --- | --- @@ -57,17 +52,17 @@ 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",