waybar-wlr-taskbar(5)         File Formats Manual        waybar-wlr-taskbar(5)

<?><?><?> (NAME)
       waybar - <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> wlr (wlr taskbar
       module)

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> taskbar <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?>
       foreign-toplevel-manager <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       <?><?> <?><?><?> wlr/taskbar <?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>

       all-outputs:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?> false <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> waybar <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.
       <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?>.

       format:
       <?><?><?>: string
       <?><?><?><?><?><?><?>: {icon}
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

       icon-theme:
       <?><?><?>: array|string
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?> <?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>. <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>.

       icon-size:
       <?><?><?>: integer
       <?><?><?><?><?><?><?>: 16
       <?><?><?><?><?><?> <?><?><?><?><?>.

       markup:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?> true <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (pango markup) <?><?>
       format <?> tooltip-format <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       tooltip:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: true
       <?><?><?> <?><?><?> false <?><?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?>.

       tooltip-format:
       <?><?><?>: string
       <?><?><?><?><?><?><?>: {title}
       <?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?>.

       active-first:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?> true <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?>
       <?><?><?><?>. <?><?> <?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>.

       sort-by-app-id:
       <?><?><?>: bool
       <?><?><?><?><?><?><?>: false
       <?><?><?> <?><?><?> true <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?> <?><?><?><?> app_id <?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?> 'active-first' <?><?><?><?><?><?><?> <?><?><?>.

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

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

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

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

       ignore-list:
       <?><?><?>: array
       <?><?><?><?><?><?> <?><?> app_id<?><?>/<?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.

       app_ids-mapping:
       <?><?><?>: object
       <?><?><?><?><?><?><?> <?><?> app_id <?><?><?><?>
       <?><?><?><?><?><?><?><?>.

       rewrite:
       <?><?><?>: object
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> (REWRITE RULES) <?><?> <?><?><?><?><?><?>.

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

       {name}: <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?> desktop <?><?> <?><?><?><?><?> <?><?> <?><?><?><?> desktop
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?> {app_id} <?><?><?>.

       {title}: <?><?><?><?><?> <?><?><?><?><?><?>.

       {app_id}: <?><?><?><?><?> <?><?><?><?><?><?> (app_id == <?><?><?>
       <?><?><?><?><?><?>).

       {state}: <?><?><?><?><?> <?><?><?><?><?><?> (minimized<?> maximized<?>
       active<?> fullscreen).

       {short_state}: <?><?><?><?><?> <?><?><?><?><?><?> (minimize == m<?>
       maximized == M<?> active == A<?> fullscreen == F) <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (CLICK ACTIONS)
       activate: <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?>.

       minimize: <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       minimize-raise: <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?> <?><?>.

       maximize: <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       fullscreen: <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?>.

       close: <?><?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?> <?><?><?><?><?><?><?><?> (REWRITE RULES)
       <?><?><?><?><?> rewrite <?><?> <?><?><?> <?><?><?> <?><?> <?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> (regex) <?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> (captures) <?><?><?><?><?> <?><?><?><?><?>.

       <?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> ECMA-script <?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?> <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>)
       <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
           "wlr/taskbar": {
                "format": "{icon}",
                "icon-size": 14,
                "icon-theme": "Numix-Circle",
                "tooltip-format": "{title}",
                "on-click": "activate",
                "on-click-middle": "close",
                "ignore-list": [
                    "Alacritty"
                ],
                "app_ids-mapping": {
                     "firefoxdeveloperedition": "firefox-developer-edition"
                },
                "rewrite": {
                     "Firefox Web Browser": "Firefox",
                     "Foot Server": "Terminal"
                }
           }

<?><?><?><?><?><?> (STYLE)
       o   #taskbar
       o   #taskbar button
       o   #taskbar button.maximized
       o   #taskbar button.minimized
       o   #taskbar button.active
       o   #taskbar button.fullscreen

                                  2026-08-31             waybar-wlr-taskbar(5)