aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: b80a846643d5313f92c0ed8f42e242cb2203d05a (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
# Simple PulseAudio volume monitor

This little monitor is my attempt to read the current volume and mute setting
of the default sink from PulseAudio and make it accessible to xmobar:

```haskell
Config { commands = [
                    , Run CommandReader "puvol-cont" "Vol"
                    ]
       , template = "%XMonadLog% }{ \
           \│ <action=`alacritty -t pamix -e pamix` button=1>%Vol%</action> \
           \│ %date% "
```

If it is called as `puvol-cont` it will wait for updates form PulseAudio, read
the current value of the mute and volume states and write an output line to
stdout.

## Installation

```shell
go install kesim.org/puvol
```

For the continous mode you have to copy or add an symbolic link with name `puvol-cont`:

```shell
cd /path/to/bin/dir
ln -s puvol puvol-cont
```