diff options
| author | Daniel Schüssler <933504+DanielSchuessler@users.noreply.github.com> | 2018-08-26 17:29:43 +0200 |
|---|---|---|
| committer | Daniel Schüssler <933504+DanielSchuessler@users.noreply.github.com> | 2018-10-06 19:53:10 +0200 |
| commit | 31fa44e9aa4ba4d3db8688d785b766fd5e7cf8f1 (patch) | |
| tree | 66c08503533c347b1917655bbd65911e4dff2616 /readme.md | |
| parent | 9050163edf67f2f510c47a482b9c156f94e89275 (diff) | |
| download | xmobar-31fa44e9aa4ba4d3db8688d785b766fd5e7cf8f1.tar.gz xmobar-31fa44e9aa4ba4d3db8688d785b766fd5e7cf8f1.tar.bz2 | |
Turn the --monitor option to `Volume` into a new plugin `Alsa` instead
See #360.
Diffstat (limited to 'readme.md')
| -rw-r--r-- | readme.md | 23 |
1 files changed, 15 insertions, 8 deletions
@@ -1063,14 +1063,6 @@ more than one battery. - `--highd` _number_ High threshold for dB. Defaults to -5.0. - `--lowd` _number_ Low threshold for dB. Defaults to -30.0. - `--volume-icon-pattern` _string_ dynamic string for current volume in `volumeipat`. - - `--monitor[=/path/to/alsactl]` - - Use event-based refreshing via `alsactl monitor` instead of polling - (`RefreshRate` will be ignored). - - If no `/path/to/alsactl` is given, `alsactl` will be sought in your `PATH` - first, and failing that, at `/usr/sbin/alsactl` (this is its location on - Debian systems. `alsactl monitor` works as a non-root user despite living - in `/usr/sbin`.). - - `stdbuf` (from coreutils) must be (and most probably already is) in your `PATH`. - Variables that can be used with the `-t`/`--template` argument: `volume`, `volumebar`, `volumevbar`, `volumeipat`, `dB`, `status` - Note that `dB` might only return 0 on your system. This is known @@ -1080,6 +1072,21 @@ more than one battery. system. In addition, to activate this plugin you must pass `--flags="with_alsa"` during compilation. +### `Alsa Mixer Element Args` + +Like [Volume](#volume-mixer-element-args-refreshrate), but with the following differences: +- Uses event-based refreshing via `alsactl monitor` instead of polling, so it will refresh + instantly when there's a volume change, and won't use CPU until a change happens. +- Aliases to `alsa:` followed by the mixer name and element name separated by a colon. Thus, + `Alsa "default" "Master" []` can be used as `%alsa:default:Master%`. +- Additional options (after the `--`): + - `--alsactl=/path/to/alsactl` + - If this option is not specified, `alsactl` will be sought in your `PATH` + first, and failing that, at `/usr/sbin/alsactl` (this is its location on + Debian systems. `alsactl monitor` works as a non-root user despite living + in `/usr/sbin`.). +- `stdbuf` (from coreutils) must be (and most probably already is) in your `PATH`. + ### `MPD Args RefreshRate` - This monitor will only be compiled if you ask for it using the |