---
name: "waybar-upower"
section: "5"
platform: "linux"
package: "waybar"
version: "0.15.0-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/waybar-upower"
---

# waybar-upower(5)

upower module

## 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

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.

## 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**