waybar-upower(5) File Formats Manual waybar-upower(5)

# [NAME](#NAME)

waybar - upower module

# [DESCRIPTION](#DESCRIPTION)

The **upower** module displays the main battery capacity with all other upower compatible devices in the tooltip.

# [CONFIGURATION](#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

GtkMenu with id **menu**

**menu-actions**:  
typeof: array  
The actions corresponding to the buttons of the menu.

# [FORMAT REPLACEMENTS](#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](#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](#STYLE)

- **#upower**
- **#upower.charging**
- **#upower.discharging**
- **#upower.full**
- **#upower.empty**
- **#upower.unknown-status**

2026-10-30

---

Document: waybar-upower(5) from waybar 0.15.0-r2 (Chainguard OS)