The battery module displays the current capacity and state (eg. charging) of your battery.

{capacity}: Capacity in percentage

{power}: Power in watts

{icon}: Icon, as defined in format-icons.

{time}: Estimate of time until full or empty. Note that this is based on the power draw at the last refresh time, not an average.

{cycles}: Amount of charge cycles the highest-capacity battery has seen. (Linux only)

{health}: The percentage of the highest-capacity battery's original maximum charge it can still hold.

The following additional replacement is available in tooltip-format (and its custom variants) only:

{timeTo}: Either an estimate of time until full or empty, or "Full", "Plugged" or "Empty" depending on the current battery status.

The battery module allows you to define how time should be formatted via format-time.

The three arguments are: {H}: Hours {M}: Minutes {m}: Zero-padded minutes

The battery module allows one to define custom formats based on up to two factors. The best-fitting format will be selected.

format-<state>: With states, a custom format can be set depending on the capacity of your battery.

format-<status>: With the status, a custom format can be set depending on the status in /sys/class/power_supply/<bat>/status (in lowercase).

format-<status>-<state>: You can also set a custom format depending on both values.

The tooltip format can be customized the same way. The best fitting from tooltip-format, tooltip-format-<state>, tooltip-format-<status> and tooltip-format-<status>-<state> will be used (using the same logic as format-*).

• Every entry (state) consists of a <name> (typeof: string) and a <value> (typeof: integer).

• The state can be addressed as a CSS class in the style.css. The name of the CSS class is the <name> of the state. Each class gets activated when the current capacity is equal to or below the configured <value>.

• Also each state can have its own format. Those can be configured via format-<name>. Or if you want to differentiate a bit more even as format-<status>-<state>. For more information see custom-formats.

Every entry in the events object consists of a <event-name> (typeof: string) and a <command> (typeof: string).
<event-name> can be in one of the following formats:

• on-<status>-<state>

• on-<status>-<capacity>

• on-<status>

Where:

• <status> is either charging or discharging,

• <state> is the name of one of the states specified in the states object,

• <capacity> is a battery level value (between 0-100).

"battery": {
	"bat": "BAT2",
	"interval": 60,
	"states": {
		"warning": 30,
		"critical": 15
	},
	"events": {
		"on-discharging-warning": "notify-send -u normal 'Low Battery'",
		"on-discharging-critical": "notify-send -u critical 'Very Low Battery'",
		"on-charging-100": "notify-send -u normal 'Battery Full!'",
		"on-discharging": "notify-send -u normal 'Power Switch' Discharging",
		"on-charging": "notify-send -u normal 'Power Switch' Charging'"
	},
	"format": "{capacity}% {icon}",
	"format-icons": ["", "", "", "", ""],
	"max-length": 25
}

Custom icon set depending on the status (format-icons as an object):

"battery": {
	"bat": "BAT2",
	"interval": 60,
	"format": "{capacity}% {icon}",
	"format-icons": {
		"default": ["󰂎", "󰁺", "󰁻", "󰁼", "󰁽", "󰁾", "󰁿", "󰂀", "󰂁", "󰂂", "󰁹"],
		"charging": ["󰢟", "󰢜", "󰂆", "󰂇", "󰂈", "󰢝", "󰂉", "󰢞", "󰂊", "󰂋", "󰂅"]
	}
}

• #battery

• #battery.<status> > > · > > <status> is the value of /sys/class/power_supply/<bat>/status in lowercase.

• #battery.<state> > > · > > <state> can be defined in the config. For more information see states.

• #battery.<status>.<state> > > · > > Combination of both <status> and <state>.

The following classes are applied to the entire Waybar rather than just the battery widget:

• window#waybar.battery-<state> > > · > > <state> can be defined in the config, as previously mentioned.