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

`pulse-volume-monitor` is a simple C++ program that listens to PulseAudio's sink and source events and emits DBus signals `sinkChanged` and `sourceChanged` when something has been changed (volume, sink or source muted, etc).

For use with AwesomeWM in volume indicator widgets.

### Usage
`./pulse-volume-monitor dbus` or `./pulse-volume-monitor stdout` (for debugging)

### AwesomeWM Lua example

```
dbus.request_name("session", "com.ch1p.pvm")
dbus.add_match("session", "interface='com.ch1p.pvm',member='sinkChanged'")
dbus.add_match("session", "interface='com.ch1p.pvm',member='sourceChanged'")
dbus.connect_signal("com.ch1p.pvm", 
    function(info)
        -- info.member is "sinkChanged" or "sourceChanged"
        -- your code here
    end
)
```