From: Luke Bonham <dadasignificanulla@gmail.com>
Date: Tue, 10 Sep 2013 20:25:23 +0000 (-0700)
Subject: Updated alsa (markdown)
X-Git-Url: https://git.madduck.net/etc/awesome.git/commitdiff_plain/f654775d456afe4f5868288007ff17a0887ddd8d?hp=d29477dac35903da00e1fe6669a2a3e90b8f1096

Updated alsa (markdown)
---

diff --git a/alsa.md b/alsa.md
index 2ca1746..3e31c74 100644
--- a/alsa.md
+++ b/alsa.md
@@ -4,43 +4,39 @@ Shows and controls alsa volume with a textbox.
 
 	myvolume = lain.widgets.alsa()
 
-* Left click: Launch `alsamixer` in your `terminal`.
-* Right click: Mute/unmute.
-* Scroll wheel: Increase/decrase volume.
-
-The function takes a table as optional argument, which can contain:
+### input table
 
 Variable | Meaning | Type | Default
 --- | --- | --- | ---
+`timeout` | Refresh timeout seconds | int | 5
 `channel` | Mixer channel | string | "Master" 
-`step` | Step at which volume is increased/decreased | string | "1%"
-`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 | " "
+`settings` | User settings | function | empty function
+
+`settings` can be fed with the following variables:
 
-*Note*: `footer` can be markup text.
+Variable | Meaning | Type | Values
+--- | --- | --- | ---
+volume.level | Self explained | int | 0-100
+volume.status | Device status | string | "on", "off"
 
-`lain.widgets.alsa` outputs the following table:
+### output table
 
 Variable | Meaning | Type
 --- | --- | --- 
 `widget` | The widget | `wibox.widget.textbox`
-`channel` | Alsa channel | string
-`step` | Increase/decrease step | string
-`notify` | Update `widget` | function
+`notify` | Force 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 .. "+")
+        awful.util.spawn("amixer sset Master 1%+")
         volume.notify()
     end),
     awful.key({ altkey }, "Down",
     function ()
-        awful.util.spawn("amixer sset " .. volume.channel .. " " .. volume.step .. "-")
+        awful.util.spawn("amixer sset Master 1%-")
         volume.notify()
     end),
     awful.key({ altkey }, "m",