summaryrefslogtreecommitdiffhomepage
path: root/readme.md
diff options
context:
space:
mode:
Diffstat (limited to 'readme.md')
-rw-r--r--readme.md94
1 files changed, 47 insertions, 47 deletions
diff --git a/readme.md b/readme.md
index cb3b9cc..003ee2a 100644
--- a/readme.md
+++ b/readme.md
@@ -542,7 +542,7 @@ Monitors have default aliases. The sections below describe every
monitor in turn, but before we provide a list of the configuration
options (or *monitor arguments*) they all share.
-### Dynamic Strings
+### Icon patterns
Some monitors allow usage of strings that depend on some integer value
from 0 to 8 by replacing all occurences of `"%%"` with it
@@ -552,9 +552,9 @@ as `"%"`, `"%%"` as `"3"`, `"%%%"` as `"3%"`, `"%%%%"` as `"33"` and so on). Ess
it allows to replace vertical bars with custom icons. For example,
Run Brightness
- [ "-t", "<dstr>"
+ [ "-t", "<ipat>"
, "--"
- , "--brightness-dynamic-string", "<icon=bright_%%.xpm/>"
+ , "--brightness-icon-pattern", "<icon=bright_%%.xpm/>"
] 30
Will display `bright_0.xpm` to `bright_8.xpm` depending on current brightness
@@ -711,11 +711,11 @@ something like:
- Aliases to the interface name: so `Network "eth0" []` can be used as
`%eth0%`
- Args: default monitor arguments, plus:
- - `--rx-dynamic-string`: dynamic string for reception rate in `rxdstr`.
- - `--tx-dynamic-string`: dynamic string for transmission rate in `txdstr`.
+ - `--rx-icon-pattern`: dynamic string for reception rate in `rxipat`.
+ - `--tx-icon-pattern`: dynamic string for transmission rate in `txipat`.
- Variables that can be used with the `-t`/`--template` argument:
- `dev`, `rx`, `tx`, `rxbar`, `rxvbar`, `rxdstr`, `txbar`, `txvbar`,
- `txdstr`. Reception and transmission rates (`rx` and `tx`) are displayed
+ `dev`, `rx`, `tx`, `rxbar`, `rxvbar`, `rxipat`, `txbar`, `txvbar`,
+ `txipat`. Reception and transmission rates (`rx` and `tx`) are displayed
by default as Kb/s, without any suffixes, but you can set the `-S` to
"True" to make them displayed with adaptive units (Kb/s, Mb/s, etc.).
- Default template: `<dev>: <rx>KB|<tx>KB`
@@ -725,11 +725,11 @@ something like:
- Active interface is detected automatically
- Aliases to "dynnetwork"
- Args: default monitor arguments, plus:
- - `--rx-dynamic-string`: dynamic string for reception rate in `rxdstr`.
- - `--tx-dynamic-string`: dynamic string for transmission rate in `txdstr`.
+ - `--rx-icon-pattern`: dynamic string for reception rate in `rxipat`.
+ - `--tx-icon-pattern`: dynamic string for transmission rate in `txipat`.
- Variables that can be used with the `-t`/`--template` argument:
- `dev`, `rx`, `tx`, `rxbar`, `rxvbar`, `rxdstr`, `txbar`, `txvbar`,
- `txdstr`. Reception and transmission rates (`rx` and `tx`) are displayed
+ `dev`, `rx`, `tx`, `rxbar`, `rxvbar`, `rxipat`, `txbar`, `txvbar`,
+ `txipat`. Reception and transmission rates (`rx` and `tx`) are displayed
in Kbytes per second, and you can set the `-S` to "True" to make them
displayed with units (the string "Kb/s").
- Default template: `<dev>: <rx>KB|<tx>KB`
@@ -739,9 +739,9 @@ something like:
- Aliases to the interface name with the suffix "wi": thus, `Wireless
"wlan0" []` can be used as `%wlan0wi%`
- Args: default monitor arguments, plus:
- - `--quality-dynamic-string`: dynamic string for connection quality in `qualitydstr`.
+ - `--quality-icon-pattern`: dynamic string for connection quality in `qualityipat`.
- Variables that can be used with the `-t`/`--template` argument:
- `essid`, `quality`, `qualitybar`, `qualityvbar`, `qualitydstr`
+ `essid`, `quality`, `qualitybar`, `qualityvbar`, `qualityipat`
- Default template: `<essid> <quality>`
- Requires the C library [iwlib] (part of the wireless tools suite)
installed in your system. In addition, to activate this plugin you
@@ -751,12 +751,12 @@ something like:
- Aliases to `memory`
- Args: default monitor arguments, plus:
- - `--used-dynamic-string`: dynamic string for used memory ratio in `useddstr`.
- - `--free-dynamic-string`: dynamic string for free memory ratio in `freedstr`.
+ - `--used-icon-pattern`: dynamic string for used memory ratio in `usedipat`.
+ - `--free-icon-pattern`: dynamic string for free memory ratio in `freeipat`.
- Variables that can be used with the `-t`/`--template` argument:
`total`, `free`, `buffer`, `cache`, `rest`, `used`,
- `usedratio`, `usedbar`, `usedvbar`, `useddstr`,
- `freeratio`, `freebar`, `freevbar`, `freedstr`
+ `usedratio`, `usedbar`, `usedvbar`, `usedipat`,
+ `freeratio`, `freebar`, `freevbar`, `freeipat`
- Default template: `Mem: <usedratio>% (<cache>M)`
### `Swap Args RefreshRate`
@@ -771,23 +771,23 @@ something like:
- Aliases to `cpu`
- Args: default monitor arguments, plus:
- - `--load-dynamic-string`: dynamic string for cpu load in `dstr`.
+ - `--load-icon-pattern`: dynamic string for cpu load in `ipat`.
- Variables that can be used with the `-t`/`--template` argument:
- `total`, `bar`, `vbar`, `dstr`, `user`, `nice`, `system`, `idle`, `iowait`
+ `total`, `bar`, `vbar`, `ipat`, `user`, `nice`, `system`, `idle`, `iowait`
- Default template: `Cpu: <total>%`
### `MultiCpu Args RefreshRate`
- Aliases to `multicpu`
- Args: default monitor arguments, plus:
- - `--load-dynamic-string`: dynamic string for overall cpu load in `dstr`.
- - `--load-dynamic-strings`: dynamic string for each cpu load in `autodstr`, `dstr{i}`.
+ - `--load-icon-pattern`: dynamic string for overall cpu load in `ipat`.
+ - `--load-icon-patterns`: dynamic string for each cpu load in `autoipat`, `ipat{i}`.
This option can be specified several times. nth option
corresponds to nth cpu.
- Variables that can be used with the `-t`/`--template` argument:
- `autototal`, `autobar`, `autovbar`, `autodstr`, `autouser`, `autonice`,
- `autosystem`, `autoidle`, `total`, `bar`, `vbar`, `dstr`, `user`, `nice`,
- `system`, `idle`, `total0`, `bar0`, `vbar0`, `dstr0`, `user0`, `nice0`,
+ `autototal`, `autobar`, `autovbar`, `autoipat`, `autouser`, `autonice`,
+ `autosystem`, `autoidle`, `total`, `bar`, `vbar`, `ipat`, `user`, `nice`,
+ `system`, `idle`, `total0`, `bar0`, `vbar0`, `ipat0`, `user0`, `nice0`,
`system0`, `idle0`, ...
The auto* variables automatically detect the number of CPUs on the system
and display one entry for each.
@@ -818,15 +818,15 @@ something like:
- `-p`: color to display positive power (battery charging)
- `-f`: file in `/sys/class/power_supply` with AC info (default:
"AC/online")
- - `--on-dynamic-string`: dynamic string for current battery charge
- when AC is "on" in `leftdstr`.
- - `--off-dynamic-string`: dynamic string for current battery charge
- when AC is "off" in `leftdstr`.
- - `--idle-dynamic-string`: dynamic string for current battery charge
- when AC is "idle" in `leftdstr`.
+ - `--on-icon-pattern`: dynamic string for current battery charge
+ when AC is "on" in `leftipat`.
+ - `--off-icon-pattern`: dynamic string for current battery charge
+ when AC is "off" in `leftipat`.
+ - `--idle-icon-pattern`: dynamic string for current battery charge
+ when AC is "idle" in `leftipat`.
- Variables that can be used with the `-t`/`--template` argument:
- `left`, `leftbar`, `leftvbar`, `leftdstr`, `timeleft`, `watts`, `acstatus`
+ `left`, `leftbar`, `leftvbar`, `leftipat`, `timeleft`, `watts`, `acstatus`
- Default template: `Batt: <watts>, <left>% / <timeleft>`
- Example (note that you need "--" to separate regular monitor options from
Battery's specific ones):
@@ -899,12 +899,12 @@ more than one battery.
- Aliases to `disku`
- Disks: list of pairs of the form (device or mount point, template),
where the template can contain `<size>`, `<free>`, `<used>`, `<freep>` or
- `<usedp>`, `<freebar>`, `<freevbar>`, `<freedstr>`, `<usedbar>`,
- `<usedvbar>` or `<useddstr>` for total, free, used, free percentage and
+ `<usedp>`, `<freebar>`, `<freevbar>`, `<freeipat>`, `<usedbar>`,
+ `<usedvbar>` or `<usedipat>` for total, free, used, free percentage and
used percentage of the given file system capacity.
- Args: default monitor arguments. `-t`/`--template` is ignored. Plus
- - `--free-dynamic-string`: dynamic string for free disk space in `freedstr`.
- - `--used-dynamic-string`: dynamic string for used disk space in `useddstr`.
+ - `--free-icon-pattern`: dynamic string for free disk space in `freeipat`.
+ - `--used-icon-pattern`: dynamic string for used disk space in `usedipat`.
- Default template: none (you must specify a template for each file system).
- Example:
@@ -918,13 +918,13 @@ more than one battery.
- Disks: list of pairs of the form (device or mount point, template),
where the template can contain `<total>`, `<read>`, `<write>` for total,
read and write speed, respectively. There are also bar versions of each:
- `<totalbar>`, `<totalvbar>`, `<totaldstr>`,
- `<readbar>`, `<readvbar>`, `<readdstr>`,
- `<writebar>`, `<writevbar>`, and `<writedstr>`.
+ `<totalbar>`, `<totalvbar>`, `<totalipat>`,
+ `<readbar>`, `<readvbar>`, `<readipat>`,
+ `<writebar>`, `<writevbar>`, and `<writeipat>`.
- Args: default monitor arguments. `-t`/`--template` is ignored. Plus
- - `--total-dynamic-string`: dynamic string for total disk I/O in `<totaldstr>`.
- - `--write-dynamic-string`: dynamic string for write disk I/O in `<writedstr>`.
- - `--read-dynamic-string`: dynamic string for read disk I/O in `<readdstr>`.
+ - `--total-icon-pattern`: dynamic string for total disk I/O in `<totalipat>`.
+ - `--write-icon-pattern`: dynamic string for write disk I/O in `<writeipat>`.
+ - `--read-icon-pattern`: dynamic string for read disk I/O in `<readipat>`.
- Default template: none (you must specify a template for each file system).
- Example:
@@ -1012,9 +1012,9 @@ more than one battery.
- Long option: `--offc`
- `--highd` _number_ High threshold for dB. Defaults to -5.0.
- `--lowd` _number_ Low threshold for dB. Defaults to -30.0.
- - `--volume-dynamic-string` _string_ dynamic string for current volume in `volumedstr`.
+ - `--volume-icon-pattern` _string_ dynamic string for current volume in `volumeipat`.
- Variables that can be used with the `-t`/`--template` argument:
- `volume`, `volumebar`, `volumevbar`, `volumedstr`, `dB`, `status`
+ `volume`, `volumebar`, `volumevbar`, `volumeipat`, `dB`, `status`
- Note that `dB` might only return 0 on your system. This is known
to happen on systems with a pulseaudio backend.
- Default template: `Vol: <volume>% <status>`
@@ -1032,9 +1032,9 @@ more than one battery.
playing, stopped and paused states in the `statei` template field.
The environment variables `MPD_HOST` and `MPD_PORT` are used to configure the
mpd server to communicate with. Also available:
- - `lapsed-dynamic-string`: dynamic string for current track position in `dstr`.
+ - `lapsed-icon-pattern`: dynamic string for current track position in `ipat`.
- Variables that can be used with the `-t`/`--template` argument:
- `bar`, `vbar`, `dstr`, `state`, `statei`, `volume`, `length`,
+ `bar`, `vbar`, `ipat`, `state`, `statei`, `volume`, `length`,
`lapsed`, `remaining`,
`plength` (playlist length), `ppos` (playlist position),
`name`, `artist`, `composer`, `performer`,
@@ -1154,9 +1154,9 @@ more than one battery.
actual_brightness)
- `-M`: file with the maximum brightness (default:
max_brightness)
- - `--brightness-dynamic-string`: dynamic string for current brightness in `dstr`.
+ - `--brightness-icon-pattern`: dynamic string for current brightness in `ipat`.
- Variables that can be used with the `-t`/`--template` argument:
- `vbar`, `percent`, `bar`, `dstr`
+ `vbar`, `percent`, `bar`, `ipat`
- Default template: `<percent>`
- Example: