1waybar-upower(5)              File Formats Manual             waybar-upower(5)
2
3
4

NAME

6       waybar - upower module
7

DESCRIPTION

9       The upower module displays the main battery capacity with all other up‐
10       ower compatible devices in the tooltip.
11

CONFIGURATION

13       native-path:
14            typeof: string
15            default:
16            The battery to monitor. Refer to the https://upower.freedesk‐
17       top.org/docs/UpDevice.html#UpDevice--native-path
18            Can be obtained using `upower --dump`
19
20       icon-size:
21            typeof: integer
22            default: 20
23            Defines the size of the icons.
24
25       format:
26            typeof: string
27            default: {percentage}
28            The text format.
29
30       format-alt:
31            typeof: string
32            default: {percentage} {time}
33            The text format when toggled.
34
35       hide-if-empty:
36            typeof: bool
37            default: true
38            Defines visibility of the module if no devices can be found.
39
40       tooltip:
41            typeof: bool
42            default: true
43            Option to disable tooltip on hover.
44
45       tooltip-spacing:
46            typeof: integer
47            default: 4
48            Defines the spacing between the tooltip device name and device
49       battery
50            status.
51
52       tooltip-padding:
53            typeof: integer
54            default: 4
55            Defines the spacing between the tooltip window edge and the
56       tooltip content.
57
58       on-click:
59            typeof: string
60            Command to execute when clicked on the module.
61

FORMAT REPLACEMENTS

63       {percentage}: The battery capacity in percentage
64
65       {time}: An estimated time either until empty or until fully charged
66       depending on the charging state.
67

EXAMPLES

69           "upower": {
70                "icon-size": 20,
71                "hide-if-empty": true,
72                "tooltip": true,
73                "tooltip-spacing": 20
74           }
75
76           "upower": {
77                "native-path": "/org/bluez/hci0/dev_D4_AE_41_38_D0_EF",
78                "icon-size": 20,
79                "hide-if-empty": true,
80                "tooltip": true,
81                "tooltip-spacing": 20
82           }
83
84           "upower": {
85                "native-path": "battery_sony_controller_battery_d0o27o88o32ofcoee",
86                "icon-size": 20,
87                "hide-if-empty": true,
88                "tooltip": true,
89                "tooltip-spacing": 20
90           }
91

STYLE

93       •   #upower
94       •   #upower.charging
95       •   #upower.discharging
96       •   #upower.full
97       •   #upower.empty
98       •   #upower.unknown-status
99
100
101
102                                  2023-08-16                  waybar-upower(5)