alsa.md

   1 Shows and controls alsa volume with a textbox.
   2
   3         myvolume = lain.widgets.alsa()
   4
   5 * Left click: Launch `alsamixer` in your `terminal`.
   6 * Right click: Mute/unmute.
   7 * Scroll wheel: Increase/decrase volume.
   8
   9 The function takes a table as optional argument, which can contain:
  10
  11 Variable | Meaning | Type | Default
  12 --- | --- | --- | ---
  13 `channel` | Mixer channel | string | "Master"
  14 `step` | Step at which volume is increased/decreased | string | "1%"
  15 `header` | Text to show before value | string | " Vol "
  16 `header_color` | Header color | string | `beautiful.fg_normal` or "#FFFFFF"
  17 `color` | Value color | string | `beautiful.fg_focus` or "#FFFFFF"
  18
  19 and outputs the following table:
  20
  21 Variable | Meaning | Type
  22 --- | --- | ---
  23 `widget` | The widget | `wibox.widget.textbox`
  24 `channel` | Alsa channel | string
  25 `step` | Increase/decrease step | string
  26 `notify` | The notification | function
  27
  28 Finally, you can control the widget with key bindings like these:
  29
  30         -- Volume control
  31         awful.key({ altkey }, "Up",
  32         function ()
  33             awful.util.spawn("amixer sset " .. volume.channel .. " " .. volume.step .. "+")
  34             volume.notify()
  35         end),
  36         awful.key({ altkey }, "Down",
  37         function ()
  38             awful.util.spawn("amixer sset " .. volume.channel .. " " .. volume.step .. "-")
  39             volume.notify()
  40         end),
  41         awful.key({ altkey }, "m",
  42         function ()
  43             awful.util.spawn("amixer set Master playback toggle")
  44             volume.notify()
  45         end),
  46         awful.key({ altkey, "Control" }, "m",
  47         function ()
  48             awful.util.spawn("amixer set Master playback 100%", false )
  49             volume.notify()
  50         end),
  51
  52 where `altkey = "Mod1"`.