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` | Update `widget` | 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"`.