summaryrefslogtreecommitdiff
path: root/volumearc-widget/README.md
blob: 38e7e050cf86bcc479fc5892f814ef97914be80a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
# Volumearc widget

Almost the same as [volumebar widget](https://github.com/streetturtle/awesome-wm-widgets/tree/master/volumebar-widget), but using arcchart:

![screenshot](out.gif)

## Customization

It is possible to customize widget by providing a table with all or some of the following config parameters:

```lua
volumearc_widget({
    main_color = '#af13f7',
    mute_color = '#ff0000',
    path_to_icon = '/usr/share/icons/Papirus-Dark/symbolic/status/audio-volume-high-symbolic.svg',
    thickness = 5,
    height = 25
})
```

Above config results in following widget:

![custom](./custom.png) 

## Installation

1. Clone this repo under **~/.config/awesome/**

    ```bash
    git clone https://github.com/streetturtle/awesome-wm-widgets.git ~/.config/awesome/
    ```

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 = '#af13f7',
                mute_color = '#ff0000',
                path_to_icon = '/usr/share/icons/Papirus-Dark/symbolic/status/audio-volume-high-symbolic.svg',
                thickness = 5,
                height = 25
            }),

            ...
    ```