summaryrefslogtreecommitdiff
path: root/volumearc-widget/README.md
diff options
context:
space:
mode:
authorPavel Makhov <pmakhov@theoctavegroup.com>2019-05-03 15:23:12 -0400
committerPavel Makhov <pmakhov@theoctavegroup.com>2019-05-03 15:23:12 -0400
commitf77df958104badf284061603e4e945b32ac6aeb6 (patch)
treec5baa0866a94db6ec3b67ec58895a375f3de4d21 /volumearc-widget/README.md
parent768b979f87fb374b607075651591425bbcda9dd6 (diff)
parent429e6eb54a5bab17d7adba8956fcbc0a63257ed5 (diff)
fix conflicts
Diffstat (limited to 'volumearc-widget/README.md')
-rw-r--r--volumearc-widget/README.md72
1 files changed, 47 insertions, 25 deletions
diff --git a/volumearc-widget/README.md b/volumearc-widget/README.md
index 79f519d..0bcd7c7 100644
--- a/volumearc-widget/README.md
+++ b/volumearc-widget/README.md
@@ -2,7 +2,43 @@
Almost the same as [volumebar widget](https://github.com/streetturtle/awesome-wm-widgets/tree/master/volumebar-widget), but using arcchart:
-![screenshot]({{'/assets/img/screenshots/volumearc-widget.gif' | relative_url }}){:.center-image}
+![screenshot](out.gif)
+
+Supports
+ - scroll up - increase volume,
+ - scroll down - decrease volume,
+ - left click - mute/unmute.
+
+## Customization
+
+It is possible to customize widget by providing a table with all or some of the following config parameters:
+
+| Name | Default | Description |
+|---|---|---|
+| `main_color` | `beautiful.fg_normal` | Color of the arc |
+| `mute_color` | `beautiful.fg_urgent` | Color of the arc when mute |
+| `path_to_icon` | /usr/share/icons/Arc/status/symbolic/audio-volume-muted-symbolic.svg | Path to the icon |
+| `thickness` | 2 | The arc thickness |
+| `height` | `beautiful.fg_normal` | Widget height |
+| `get_volume_cmd` | `amixer -D pulse sget Master` | Get current volume level |
+| `inc_volume_cmd` | `amixer -D pulse sset Master 5%+` | Increase volume level |
+| `dec_volume_cmd` | `amixer -D pulse sset Master 5%-` | Descrease volume level |
+| `tog_volume_cmd` | `amixer -D pulse sset Master toggle` | Mute / unmute |
+
+### Example:
+
+```lua
+volumearc_widget({
+ main_color = '#af13f7',
+ mute_color = '#ff0000',
+ thickness = 5,
+ height = 25
+})
+```
+
+Above config results in following widget:
+
+![custom](./custom.png)
## Installation
@@ -14,27 +50,13 @@ Almost the same as [volumebar widget](https://github.com/streetturtle/awesome-wm
1. Require volumearc widget at the beginning of **rc.lua**:
- ```lua
- local volumearc_widget = require("awesome-wm-widgets.volumearc-widget.volumearc")
- ```
-
-1. Add widget to the tasklist:
-
- ```lua
- s.mytasklist, -- Middle widget
- { -- Right widgets
- layout = wibox.layout.fixed.horizontal,
- ...
- --[[default]]
- volumearc_widget(),
- --[[or customized]]
- volumearc_widget({
- main_color = '#0000ff',
- mute_color = '#ff0000',
- path_to_icon = '/usr/share/icons/Arc/actions/symbolic/view-grid-symbolic.svg',
- thickness = 5,
- height = 25
- }),
-
- ...
- ``` \ No newline at end of file
+```lua
+require("volumearc")
+...
+s.mytasklist, -- Middle widget
+ { -- Right widgets
+ layout = wibox.layout.fixed.horizontal,
+ ...
+ volumearc_widget,
+ ...
+```