AlexandClaude Opus 4.8
a3b39cfcf6
Port information that previously lived only in the GitHub wiki into the authoritative scdoc man pages, so the man pages become the single source of truth for module documentation. 33 man pages enriched (options, format replacements, actions, style selectors, troubleshooting and implementation notes). Additions were verified against the source; stale/incorrect wiki entries were deliberately not ported. All pages still compile with scdoc. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
151 lines
2.9 KiB
Scdoc
151 lines
2.9 KiB
Scdoc
waybar-upower(5)
|
|
|
|
# NAME
|
|
|
|
waybar - upower module
|
|
|
|
# DESCRIPTION
|
|
|
|
The *upower* module displays the main battery capacity with all other upower
|
|
compatible devices in the tooltip.
|
|
|
|
# CONFIGURATION
|
|
|
|
*native-path*: ++
|
|
typeof: string ++
|
|
default: ++
|
|
The battery to monitor. Refer to the https://upower.freedesktop.org/docs/UpDevice.html#UpDevice--native-path ++
|
|
Can be obtained using `upower --dump`
|
|
|
|
*model*: ++
|
|
typeof: string ++
|
|
default: ++
|
|
The battery to monitor, based on the model. (this option is ignored if *native-path* is given). ++
|
|
Can be obtained using `upower --dump`
|
|
|
|
*icon-size*: ++
|
|
typeof: integer ++
|
|
default: 20 ++
|
|
Defines the size of the icons. Set to *0* for automatic sizing.
|
|
|
|
*format*: ++
|
|
typeof: string ++
|
|
default: {percentage} ++
|
|
The text format.
|
|
|
|
*format-alt*: ++
|
|
typeof: string ++
|
|
default: {percentage} {time} ++
|
|
The text format when toggled.
|
|
|
|
*hide-if-empty*: ++
|
|
typeof: bool ++
|
|
default: true ++
|
|
Defines visibility of the module if no devices can be found.
|
|
|
|
*tooltip*: ++
|
|
typeof: bool ++
|
|
default: true ++
|
|
Option to disable tooltip on hover.
|
|
|
|
*tooltip-spacing*: ++
|
|
typeof: integer ++
|
|
default: 4 ++
|
|
Defines the spacing between the tooltip device name and device battery ++
|
|
status.
|
|
|
|
*tooltip-padding*: ++
|
|
typeof: integer ++
|
|
default: 4 ++
|
|
Defines the spacing between the tooltip window edge and the tooltip content.
|
|
|
|
*tooltip-format*: ++
|
|
typeof: string ++
|
|
default: ++
|
|
The format used for each device line shown in the tooltip. Accepts the ++
|
|
same replacements as *format*.
|
|
|
|
*on-click*: ++
|
|
typeof: string ++
|
|
Command to execute when clicked on the module.
|
|
|
|
*show-icon*: ++
|
|
typeof: bool ++
|
|
default: true ++
|
|
Option to disable battery icon.
|
|
|
|
*menu*: ++
|
|
typeof: string ++
|
|
Action that popups the menu.
|
|
|
|
*menu-file*: ++
|
|
typeof: string ++
|
|
Location of the menu descriptor file. There need to be an element of type
|
|
GtkMenu with id *menu*
|
|
|
|
*menu-actions*: ++
|
|
typeof: array ++
|
|
The actions corresponding to the buttons of the menu.
|
|
|
|
# FORMAT REPLACEMENTS
|
|
|
|
*{percentage}*: The battery capacity in percentage
|
|
|
|
*{time}*: An estimated time either until empty or until fully charged ++
|
|
depending on the charging state.
|
|
|
|
*{temperature}*: The battery temperature in degrees Celsius.
|
|
|
|
*{model}*: The model name of the device.
|
|
|
|
*{native-path}*: The native path of the device.
|
|
|
|
# EXAMPLES
|
|
|
|
```
|
|
"upower": {
|
|
"icon-size": 20,
|
|
"hide-if-empty": true,
|
|
"tooltip": true,
|
|
"tooltip-spacing": 20
|
|
}
|
|
|
|
```
|
|
```
|
|
"upower": {
|
|
"native-path": "/org/bluez/hci0/dev_D4_AE_41_38_D0_EF",
|
|
"icon-size": 20,
|
|
"hide-if-empty": true,
|
|
"tooltip": true,
|
|
"tooltip-spacing": 20
|
|
}
|
|
|
|
```
|
|
```
|
|
"upower": {
|
|
"native-path": "battery_sony_controller_battery_d0o27o88o32ofcoee",
|
|
"icon-size": 20,
|
|
"hide-if-empty": true,
|
|
"tooltip": true,
|
|
"tooltip-spacing": 20
|
|
}
|
|
```
|
|
```
|
|
"upower": {
|
|
"show-icon": false,
|
|
"hide-if-empty": true,
|
|
"tooltip": true,
|
|
"tooltip-spacing": 20
|
|
}
|
|
|
|
```
|
|
|
|
# STYLE
|
|
|
|
- *#upower*
|
|
- *#upower.charging*
|
|
- *#upower.discharging*
|
|
- *#upower.full*
|
|
- *#upower.empty*
|
|
- *#upower.unknown-status*
|