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

<?><?><?> (NAME)
       waybar-battery - <?><?><?><?><?> <?><?><?><?><?> (battery) <?><?>
       waybar

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> battery <?><?><?><?><?> <?><?><?><?> <?>
       <?><?><?><?><?> (<?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?>)
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       bat:
       <?><?><?>: string
       <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       /sys/class/power_supply/ <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       adapter:
       <?><?><?>: string
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       /sys/class/power_supply/ <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

       full-at:
       <?><?><?>: integer
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?><?>
       <?> <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>.

       design-capacity:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?>.

       interval:
       <?><?><?>: integer
       <?><?><?><?><?><?><?>: 60
       <?><?><?><?><?> <?><?><?><?><?> (<?><?> <?><?><?><?><?>) <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> <?> <?><?><?><?>
       <?><?><?><?><?><?>.

       states:
       <?><?><?>: object
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?> waybar-states(5) <?><?>
       <?><?><?><?><?><?>.

       format:
       <?><?><?>: string
       <?><?><?><?><?><?><?>: {capacity}%
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       format-time:
       <?><?><?>: string
       <?><?><?><?><?><?><?>: {H} h {M} min
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       format-icons:
       <?><?><?>: array/object
       <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?> <?><?> low (<?><?>) <?><?> high (<?><?><?><?>)
       <?><?><?>. <?><?> <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       max-length:
       <?><?><?>: integer
       <?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> (<?><?><?><?><?><?><?><?><?>) <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

       min-length:
       <?><?><?>: integer
       <?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       align:
       <?><?><?>: float
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?> <?><?> 0 <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?> 1 <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>. <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?>.

       justify:
       <?><?><?>: string
       <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?> 'left' (<?><?>)<?> 'right'
       (<?><?><?><?>) <?><?> 'center' (<?><?><?>) <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       rotate:
       <?><?><?>: integer
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> (<?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>).

       on-click:
       <?><?><?>: string
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       on-click-middle:
       <?><?><?>: string
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       on-click-right:
       <?><?><?>: string
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>.

       on-update:
       <?><?><?>: string
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?>.

       on-scroll-up:
       <?><?><?>: string
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> (<?><?><?><?><?><?>) <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>.

       weighted-average:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: true
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>.

       on-scroll-down:
       <?><?><?>: string
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> (<?><?><?><?><?><?>) <?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>.

       smooth-scrolling-threshold:
       <?><?><?>: double
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?>.

       tooltip:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: true
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> (tooltip)
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?>.

       bat-compatibility:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?> <?><?>.

       menu:
       <?><?><?>: string
       <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> (popup).

       menu-file:
       <?><?><?>: string
       <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?>
           GtkMenu <?><?> <?><?><?><?><?> menu <?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.

       menu-actions:
       <?><?><?>: array
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
       <?><?><?>.

       expand:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>.

       events:
       <?><?><?>: object
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?><?><?> (EVENTS) <?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (FORMAT REPLACEMENTS)
       {capacity}: <?><?><?><?><?> <?><?> <?><?><?><?>

       {power}: <?><?><?><?> <?><?> <?><?><?> <?><?><?>

       {icon}: <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       format-icons.

       {time}: <?><?><?><?><?> <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?>. <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?><?>.

       {cycles}: <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>. (<?><?><?>
       <?><?><?><?><?><?>)

       {health}: <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>.

<?><?><?><?> <?><?><?><?> (TIME FORMAT)
       <?><?><?><?><?> battery <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?> <?><?><?><?> format-time <?><?><?><?>
       <?><?><?><?>.

       <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>: {H}:
       <?><?><?><?> {M}: <?><?><?><?><?> {m}: <?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?>

<?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (CUSTOM FORMATS)
       <?><?><?><?><?> battery <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?>.

       format-<state>: <?><?> <?><?><?><?><?> states<?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>.

       format-<status>: <?><?> <?><?><?><?><?> (status)<?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
       /sys/class/power_supply/<bat>/status (<?><?> <?><?><?><?> <?><?><?><?>)
       <?><?><?><?><?> <?><?><?>.

       format-<status>-<state>: <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> (STATES)
       o   <?><?> <?><?><?><?> (state) <?><?><?><?> <?><?> <name> (<?><?><?>:
           string) <?> <?><?> <value> (<?><?><?>: integer) <?><?><?>.
       o   <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?> CSS <?><?> style.css
           <?><?><?><?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?> CSS
           <?><?><?><?> <name> <?><?><?><?><?> <?><?><?>. <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?> <value> <?><?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?><?>.
       o   <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           format <?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?>. <?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> format-<name> <?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> format-<status>-<state> <?><?><?><?><?><?><?><?>
           <?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (custom-formats) <?><?>
           <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (EVENTS)
       <?><?> <?><?><?><?> <?><?> <?><?><?> events <?><?><?><?> <?><?>
       <event-name> (<?><?><?>: string) <?> <?><?> <command> (<?><?><?>:
       string) <?><?><?>.
       <event-name> <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?>:

       o   on-<status>-<state>
       o   on-<status>-<capacity>

       <?><?> <?><?> <?><?>:

       o   <status> <?><?><?> <?><?> <?><?><?><?><?><?> charging <?><?>
           discharging <?><?><?><?>
       o   <state> <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?> states <?><?><?><?>
       o   <capacity> <?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?> (<?><?><?> 0-100).

<?><?><?><?><?><?><?> (EXAMPLES)
           "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!'"
                },
                "format": "{capacity}% {icon}",
                "format-icons": ["<?>", "<?>", "<?>", "<?>", "<?>"],
                "max-length": 25
           }

<?><?><?><?><?><?> (STYLE)
       o   #battery
       o   #battery.<status>
           o   <status> <?><?><?><?><?> /sys/class/power_supply/<bat>/status
               <?><?> <?><?><?><?> <?><?><?><?> <?><?><?>.
       o   #battery.<state>
           o   <state> <?><?> <?><?><?><?><?><?><?> <?><?> config
               <?><?><?><?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?><?><?> (states) <?><?>
               <?><?><?><?><?><?>.
       o   #battery.<status>.<state>
           o   <?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <status> <?>
               <state>.

       <?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?> Waybar
       <?><?><?><?><?> <?><?><?><?><?><?><?>:

       o   window#waybar.battery-<state>
           o   <state> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
               <?><?> <?><?><?><?><?><?> <?><?><?> <?><?> <?><?> config
               <?><?><?><?><?> <?><?><?>.

                                  2026-08-31                 waybar-battery(5)