aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: f1bbc4c5bd3d9518edb7ea5901e8c18daf0e36c4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# alsa-volume-monitor

`alsa-volume-monitor` is a simple program written in C that listens to ALSA events and emits a DBus signal when something has been changed (e.g. volume).

It was created for use with Awesome WM in volume indicator widgets.

### Usage
`./alsa-volume-monitor hw:0`, where `hw:0` is the name of your audio card.

### Catch events from Awesome config

```
dbus.request_name("session", "com.ch1p.avm")
dbus.add_match("session", "interface='com.ch1p.avm',member='valueChanged'")
dbus.connect_signal("com.ch1p.avm", function(...)
        -- Update your widget here
    end
)
```

### License
GPLv2