Updated alsa (markdown)

This commit is contained in:
Luke Bonham 2013-09-10 13:25:23 -07:00 committed by copycat-killer
parent 2098a3ef16
commit cc7173f060
1 changed files with 13 additions and 17 deletions

30
alsa.md
View File

@ -4,43 +4,39 @@ Shows and controls alsa volume with a textbox.
myvolume = lain.widgets.alsa() myvolume = lain.widgets.alsa()
* Left click: Launch `alsamixer` in your `terminal`. ### input table
* Right click: Mute/unmute.
* Scroll wheel: Increase/decrase volume.
The function takes a table as optional argument, which can contain:
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%" `settings` | User settings | function | empty function
`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 | " "
*Note*: `footer` can be markup text. `settings` can be fed with the following variables:
`lain.widgets.alsa` outputs the following table: Variable | Meaning | Type | Values
--- | --- | --- | ---
volume.level | Self explained | int | 0-100
volume.status | Device status | string | "on", "off"
### output table
Variable | Meaning | Type Variable | Meaning | Type
--- | --- | --- --- | --- | ---
`widget` | The widget | `wibox.widget.textbox` `widget` | The widget | `wibox.widget.textbox`
`channel` | Alsa channel | string `notify` | Force update `widget` | function
`step` | Increase/decrease step | string
`notify` | Update `widget` | function
Finally, you can control the widget with key bindings like these: Finally, you can control the widget with key bindings like these:
-- Volume control -- Volume control
awful.key({ altkey }, "Up", awful.key({ altkey }, "Up",
function () function ()
awful.util.spawn("amixer sset " .. volume.channel .. " " .. volume.step .. "+") awful.util.spawn("amixer sset Master 1%+")
volume.notify() volume.notify()
end), end),
awful.key({ altkey }, "Down", awful.key({ altkey }, "Down",
function () function ()
awful.util.spawn("amixer sset " .. volume.channel .. " " .. volume.step .. "-") awful.util.spawn("amixer sset Master 1%-")
volume.notify() volume.notify()
end), end),
awful.key({ altkey }, "m", awful.key({ altkey }, "m",