Updated alsabar (markdown)

[etc/awesome.git] / alsabar.md

diff --git a/alsabar.md b/alsabar.md
index 52fa4173b61cc69d239e0c4900a6e37ecec8ff37..ad5b1bfe4ff7281a488dfb4dd199982cb8c7574f 100644 (file)
--- a/alsabar.md
+++ b/alsabar.md
@@ -1,10 +1,6 @@
-Shows and controls alsa volume with a progressbar.
+[<- widgets](https://github.com/copycat-killer/lain/wiki/Widgets)

 
 

-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()
 
 
        myvolumebar = lain.widgets.alsabar()
 


@@ -16,6 +12,7 @@ The function takes a table as optional argument, which can contain:
 
 Variable | Meaning | Type | Default
 --- | --- | --- | ---
 
 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
 `width` | Bar width | int | 63
 `height` | Bar height | int | 1
 `ticks` | Set bar ticks on | boolean | true


@@ -40,12 +37,13 @@ Variable | Meaning | Type | Default
 --- | --- | --- | ---
 `font` | Notifications font | string | The one defined in `beautiful.font`
 `font_size` | Notifications font size | string | "11"
 --- | --- | --- | ---
 `font` | Notifications font | string | The one defined in `beautiful.font`
 `font_size` | Notifications font size | string | "11"

+`color` | Notifications color | string | `beautiful.fg_focus`

 `bar_size` | Wibox height | int | 18
 
 It's **crucial** to set `notifications.bar_size` to your `mywibox[s]` height,
 **if** you have set it different than default (18). 
 
 `bar_size` | Wibox height | int | 18
 
 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
 --- | --- | ---
 
 Variable | Meaning | Type
 --- | --- | ---


@@ -54,17 +52,17 @@ Variable | Meaning | Type
 `step` | Increase/decrease step | string
 `notify` | The notification | function
 
 `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 ()
 
     -- 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 ()
         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",
         volume.notify()
     end),
     awful.key({ altkey }, "m",


@@ -76,6 +74,6 @@ Finally, you can control the widget with key bindings like these:
     function ()
         awful.util.spawn("amixer set Master playback 100%", false )
         volume.notify()
     function ()
         awful.util.spawn("amixer set Master playback 100%", false )
         volume.notify()

-     end),
+    end),

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