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.

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.

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

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.

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