AlexandClaude Opus 4.8
72fdf77c19
A full man<->code consistency audit surfaced options, format placeholders
and CSS classes that were implemented but undocumented, documented but not
implemented (some causing fmt crashes when copied from examples), and
defaults that disagreed with the code. This aligns the docs with the code
and fixes a few genuine code gaps.
Docs:
- Add the missing waybar-user(5) man page (and register it in meson.build)
- Document previously-undocumented options/placeholders/CSS across many
modules (custom image-path/image-name/icon-size, graph_type/width/
datapoints; battery smooth-power; wireplumber format-source/only-physical;
mpris {position}/prefer-album-artist; network {signalStrengthApp}/compact
bandwidth; pulseaudio {source_volume}/{source_desc}; upower {temperature}/
{model}/{native-path}; wwan {power_state}/{imei}; tray ignore-list; and
many CSS state classes: .sink-muted, .source-muted, .workspace-hover, etc.)
- Correct documented defaults to match the code (hyprland format {name},
gamemode {count}, cpu-graph interval 5, cava input_delay 4, niri taskbar
icon-size 16, disk/gps/wayfire formats, menu-actions object type, ...)
- Remove placeholders/options that do not apply (custom-graph {icon}/format/
format-icons/rotate) and fix crashing examples (wwan {mode}, gps
format-no-fix); note cava background/foreground/continuous_rendering are
cava-config-file options
Code:
- bluetooth: accept the documented `controller` key as a synonym of
`controller-alias` (the option was silently ignored)
- mango/workspaces: supply the documented `{name}` fmt arg (was missing ->
fmt::format threw)
- privacy: read `tooltip` as a bool (was guarded on isString(), so the
documented `tooltip: false` was silently ignored)
All man pages validated with scdoc 1.11.4. Not compiled locally (no gtkmm);
C++ build relies on CI.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
164 lines
4.1 KiB
Scdoc
164 lines
4.1 KiB
Scdoc
waybar-cpu(5)
|
|
|
|
# NAME
|
|
|
|
waybar - cpu module
|
|
|
|
# DESCRIPTION
|
|
|
|
The *cpu* module displays the current CPU utilization.
|
|
|
|
# CONFIGURATION
|
|
|
|
*interval*: ++
|
|
typeof: integer or float ++
|
|
default: 10 ++
|
|
The interval in which the information gets polled. ++
|
|
Minimum value is 0.001 (1ms). Values smaller than 1ms will be set to 1ms.
|
|
|
|
*format*: ++
|
|
typeof: string ++
|
|
default: {usage}% ++
|
|
The format, how information should be displayed. On {} data gets inserted.
|
|
|
|
*format-icons*: ++
|
|
typeof: array/object ++
|
|
Based on the current usage, the corresponding icon gets selected. ++
|
|
The order is *low* to *high*. Or by the state if it is an object.
|
|
|
|
*max-length*: ++
|
|
typeof: integer ++
|
|
The maximum length in character the module should display.
|
|
|
|
*min-length*: ++
|
|
typeof: integer ++
|
|
The minimum length in characters the module should accept.
|
|
|
|
*align*: ++
|
|
typeof: float ++
|
|
The alignment of the label within the module, where 0 is left-aligned and 1 is right-aligned. If the module is rotated, it will follow the flow of the text.
|
|
|
|
*justify*: ++
|
|
typeof: string ++
|
|
The alignment of the text within the module's label, allowing options 'left', 'right', or 'center' to define the positioning.
|
|
|
|
*rotate*: ++
|
|
typeof: integer ++
|
|
Positive value to rotate the text label (in 90 degree increments).
|
|
|
|
*states*: ++
|
|
typeof: object ++
|
|
A number of CPU usage states which get activated on certain usage levels. See *waybar-states(5)*.
|
|
|
|
*on-click*: ++
|
|
typeof: string ++
|
|
Command to execute when clicked on the module.
|
|
|
|
*on-click-middle*: ++
|
|
typeof: string ++
|
|
Command to execute when middle-clicked on the module using mousewheel.
|
|
|
|
*on-click-right*: ++
|
|
typeof: string ++
|
|
Command to execute when you right-click on the module.
|
|
|
|
*on-update*: ++
|
|
typeof: string ++
|
|
Command to execute when the module is updated.
|
|
|
|
*on-scroll-up*: ++
|
|
typeof: string ++
|
|
Command to execute when scrolling up on the module.
|
|
|
|
*on-scroll-down*: ++
|
|
typeof: string ++
|
|
Command to execute when scrolling down on the module.
|
|
|
|
*smooth-scrolling-threshold*: ++
|
|
typeof: double ++
|
|
Threshold to be used when scrolling.
|
|
|
|
*tooltip*: ++
|
|
typeof: bool ++
|
|
default: true ++
|
|
Option to disable tooltip on hover.
|
|
|
|
*tooltip-format*: ++
|
|
typeof: string ++
|
|
The format of the tooltip shown on hover. Supports the same replacements as *format*.
|
|
|
|
*format-<state>*: ++
|
|
typeof: string ++
|
|
The format to use when the given *state* (see *states*) is active. Supports the same replacements as *format*.
|
|
|
|
*tooltip-format-<state>*: ++
|
|
typeof: string ++
|
|
The tooltip format to use when the given *state* (see *states*) is active. Takes precedence over *tooltip-format*.
|
|
|
|
*expand*: ++
|
|
typeof: bool ++
|
|
default: false ++
|
|
Enables this module to consume all left over space dynamically.
|
|
|
|
# FORMAT REPLACEMENTS
|
|
|
|
*{load}*: Current CPU load.
|
|
|
|
*{load1}*: CPU load average over the last minute.
|
|
|
|
*{load5}*: CPU load average over the last 5 minutes.
|
|
|
|
*{load15}*: CPU load average over the last 15 minutes.
|
|
|
|
*{usage}*: Current overall CPU usage.
|
|
|
|
*{usage*{n}*}*: Current CPU core n usage. Cores are numbered from zero, so first core will be {usage0} and 4th will be {usage3}.
|
|
|
|
*{avg_frequency}*: Current CPU average frequency (based on all cores) in GHz.
|
|
|
|
*{max_frequency}*: Current CPU max frequency (based on the core with the highest frequency) in GHz.
|
|
|
|
*{min_frequency}*: Current CPU min frequency (based on the core with the lowest frequency) in GHz.
|
|
|
|
*{icon}*: Icon for overall CPU usage.
|
|
|
|
*{icon*{n}*}*: Icon for CPU core n usage. Use like {icon0}.
|
|
|
|
*{icons}*: All per-core icons concatenated. Equivalent to {icon0}{icon1}...{icon*N*} but adapts to the number of cores automatically.
|
|
|
|
# EXAMPLES
|
|
|
|
Basic configuration:
|
|
|
|
```
|
|
"cpu": {
|
|
"interval": 10,
|
|
"format": "{}% ",
|
|
"max-length": 10
|
|
}
|
|
```
|
|
|
|
CPU usage per core rendered as icons:
|
|
|
|
```
|
|
"cpu": {
|
|
"interval": 1,
|
|
"format": "{icon0}{icon1}{icon2}{icon3} {usage:>2}% ",
|
|
"format-icons": ["▁", "▂", "▃", "▄", "▅", "▆", "▇", "█"],
|
|
},
|
|
```
|
|
|
|
Automatically determine number of icons according to number of logical cores:
|
|
|
|
```
|
|
"cpu": {
|
|
"interval": 1,
|
|
"format": "{icons} {usage:>2}% ",
|
|
"format-icons": ["▁", "▂", "▃", "▄", "▅", "▆", "▇", "█"],
|
|
},
|
|
```
|
|
|
|
# STYLE
|
|
|
|
- *#cpu*
|