Updated alsa (markdown)

[etc/awesome.git] / alsa.md

diff --git a/alsa.md b/alsa.md
index 337f7e80ab797fdf78d2a60a06e8b6bd30eb86e2..daf4016fafe0bf1504d08e5395972a4152d19484 100644 (file)
--- a/alsa.md
+++ b/alsa.md
@@ -2,56 +2,52 @@
 
 Shows and controls alsa volume with a textbox.
 
 
 Shows and controls alsa volume with a textbox.
 

-       myvolume = lain.widgets.alsa()
+       volumewidget = 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
 --- | --- | --- | ---
 
 Variable | Meaning | Type | Default
 --- | --- | --- | ---

+`timeout` | Refresh timeout seconds | int | 5

 `channel` | Mixer channel | string | "Master" 
 `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 use the following variables:

 
 

-*Note*: `footer` can be markup text.
+Variable | Meaning | Type | Values
+--- | --- | --- | ---
+`volume_now.level` | Self explained | int | 0-100
+`volume_now.status` | Device status | string | "on", "off"

 
 

-`lain.widgets.alsa` outputs the following table:
+### output table

 
 Variable | Meaning | Type
 --- | --- | --- 
 `widget` | The widget | `wibox.widget.textbox`
 
 Variable | Meaning | Type
 --- | --- | --- 
 `widget` | The widget | `wibox.widget.textbox`

-`channel` | Alsa channel | string
-`step` | Increase/decrease step | string
-`notify` | Update `widget` | function
+`update` | Update `widget` | 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 ()
 
     -- Volume control
     awful.key({ altkey }, "Up",
     function ()

-        awful.util.spawn("amixer sset " .. volume.channel .. " " .. volume.step .. "+")
-        volume.notify()
+        awful.util.spawn("amixer set Master 1%+")
+        volumewidget.update()

     end),
     awful.key({ altkey }, "Down",
     function ()
     end),
     awful.key({ altkey }, "Down",
     function ()

-        awful.util.spawn("amixer sset " .. volume.channel .. " " .. volume.step .. "-")
-        volume.notify()
+        awful.util.spawn("amixer set Master 1%-")
+        volumewidget.update()

     end),
     awful.key({ altkey }, "m",
     function ()
         awful.util.spawn("amixer set Master playback toggle")
     end),
     awful.key({ altkey }, "m",
     function ()
         awful.util.spawn("amixer set Master playback toggle")

-        volume.notify()
+        volumewidget.update()

     end),
     awful.key({ altkey, "Control" }, "m", 
     function ()
         awful.util.spawn("amixer set Master playback 100%", false )
     end),
     awful.key({ altkey, "Control" }, "m", 
     function ()
         awful.util.spawn("amixer set Master playback 100%", false )

-        volume.notify()
+        volumewidget.update()

     end),
 
 where `altkey = "Mod1"`.
\ No newline at end of file
     end),
 
 where `altkey = "Mod1"`.
\ No newline at end of file