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

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

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> bluetooth <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       <?><?> bluetooth <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>

       controller:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?> (alias) <?><?><?><?><?><?><?><?><?>.
       <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?> <?><?> <?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?>.

       format-device-preference:
       <?><?><?>: <?><?><?><?><?> (array)
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>.
       <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?>.

       format:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?><?><?><?>: <?> {status}
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

       format-disabled:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>.

       format-off:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       format-on:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

       format-connected:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

       format-no-controller:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

       format-icons:
       <?><?><?>: <?><?><?><?><?>/<?><?><?> (array/object)
       <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       (<?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> (EXPERIMENTAL BATTERY PERCENTAGE FEATURE) <?><?>
       <?><?><?><?><?><?>)<?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?> <?><?> low (<?><?>) <?><?> high (<?><?><?><?>)
       <?><?><?>. <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       *-connected-battery <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?>.
       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?> <?><?> <?><?><?> <?><?><?><?>. <?><?><?> <?><?><?><?><?><?>
       <?><?> (on<?> off<?> connected) <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> (enabled)
       <?><?><?><?><?><?><?><?><?><?>.

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

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

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

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

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

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

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

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

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

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

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

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

       tooltip-format:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?>. <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>.

       tooltip-format-disabled:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?>.

       tooltip-format-off:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       tooltip-format-on:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>.

       tooltip-format-connected:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?>
       <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

       tooltip-format-no-controller:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>.

       tooltip-format-enumerate-connected:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> device_enumerate <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.

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

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

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

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

<?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> (FORMAT
       REPLACEMENTS)
       {status}: <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>.

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

       {num_connections}: <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.

       {controller_address}: <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       {controller_address_type}: <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.

       {controller_alias}: <?><?><?> <?><?><?><?><?><?> (alias)
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.

       {device_address}: <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?>.

       {device_address_type}: <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       {device_alias}: <?><?><?> <?><?><?><?><?><?> (alias) <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?>.

       {device_enumerate}: <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?><?><?>. <?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> tooltip-format-enumerate-connected
       <?>/<?><?> tooltip-format-enumerate-connected-battery <?><?><?><?><?>
       <?><?><?><?>. <?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> (tooltip)
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

<?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       (EXPERIMENTAL BATTERY PERCENTAGE FEATURE)
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> BlueZ <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?>.

   <?><?><?><?><?><?><?> <?><?><?><?> (FORMAT REPLACEMENT)
       {device_battery_percentage}: <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>. <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?>.

   <?><?><?><?><?><?><?><?> (CONFIGURATION)
       format-connected-battery:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?>.

       tooltip-format-connected-battery:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?>.

       tooltip-format-enumerate-connected-battery:
       <?><?><?>: <?><?><?><?> (string)
       <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> device_enumerate <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
       tooltip-format-enumerate-connected <?><?><?><?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
           "bluetooth": {
                // "controller": "controller1", // <?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?>
                "format": "<?> {status}",
                "format-disabled": "", // <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
                "format-connected": "<?> {num_connections} connected",
                "tooltip-format": "{controller_alias}\t{controller_address}",
                "tooltip-format-connected": "{controller_alias}\t{controller_address}\n\n{device_enumerate}",
                "tooltip-format-enumerate-connected": "{device_alias}\t{device_address}"
           }

           "bluetooth": {
                "format": "<?> {status}",
                "format-connected": "<?> {device_alias}",
                "format-connected-battery": "<?> {device_alias} {device_battery_percentage}%",
                // "format-device-preference": [ "device1", "device2" ], // <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
                "tooltip-format": "{controller_alias}\t{controller_address}\n\n{num_connections} connected",
                "tooltip-format-connected": "{controller_alias}\t{controller_address}\n\n{num_connections} connected\n\n{device_enumerate}",
                "tooltip-format-enumerate-connected": "{device_alias}\t{device_address}",
                "tooltip-format-enumerate-connected-battery": "{device_alias}\t{device_address}\t{device_battery_percentage}%"
           }

<?><?><?><?><?><?> (STYLE)
       o   #bluetooth
       o   #bluetooth.disabled
       o   #bluetooth.off
       o   #bluetooth.on
       o   #bluetooth.connected
       o   #bluetooth.discoverable
       o   #bluetooth.discovering
       o   #bluetooth.pairable

                                  2026-08-31               waybar-bluetooth(5)