NAME

       waybar - wlr taskbar module

DESCRIPTION

       The taskbar module displays the currently open applications. This module requires a
       compositor that implements the foreign-toplevel-manager interface.

CONFIGURATION

       Addressed by wlr/taskbar

       all-outputs:
            typeof: bool
            default: false
            If set to false applications on the waybar's current output will be shown. Otherwise
       all applications are shown.

       format:
            typeof: string
            default: {icon}
            The format, how information should be displayed.

       icon-theme:
            typeof: array|string
            The names of the icon-themes that should be used to find an icon. The list will be
       traversed from left to right. If omitted, the system default will be used.

       icon-size:
            typeof: integer
            default: 16
            The size of the icon.

       markup:
            typeof: bool
            default: false
            If set to true, pango markup will be accepted in format and tooltip-format.

       tooltip:
            typeof: bool
            default: true
            If set to false no tooltip will be shown.

       tooltip-format:
            typeof: string
            default: {title}
            The format, how information in the tooltip should be displayed.

       active-first:
            typeof: bool
            default: false
            If set to true, always reorder the tasks in the taskbar so that the currently active
       one is first. Otherwise don't reorder.

       sort-by-app-id:
            typeof: bool
            default: false
            If set to true, group tasks by their app_id. Cannot be used with 'active-first'.

       on-click:
            typeof: string
            The action which should be triggered when clicking on the application button with the
       left mouse button.

       on-click-middle:
            typeof: string
            The action which should be triggered when clicking on the application button with the
       middle mouse button.

       on-click-right:
            typeof: string
            The action which should be triggered when clicking on the application button with the
       right mouse button.

       on-update:
            typeof: string
            Command to execute when the module is updated.

       ignore-list:
            typeof: array
            List of app_id/titles to be invisible.

       app_ids-mapping:
            typeof: object
            Dictionary of app_id to be replaced with

       rewrite:
            typeof: object
            Rules to rewrite the module format output. See rewrite rules.

FORMAT REPLACEMENTS

       {icon}: The icon of the application.

       {name}: The application name as in desktop file if appropriate desktop fils found,
       otherwise same as {app_id}

       {title}: The title of the application.

       {app_id}: The app_id (== application name) of the application.

       {state}: The state (minimized, maximized, active, fullscreen) of the application.

       {short_state}: The state (minimize == m, maximized == M, active == A, fullscreen == F)
       represented as one character of the application.

CLICK ACTIONS

       activate: Bring the application into foreground.

       minimize: Toggle application's minimized state.

       minimize-raise: Bring the application into foreground or toggle its minimized state.

       maximize: Toggle application's maximized state.

       fullscreen: Toggle application's fullscreen state.

       close: Close the application.

REWRITE RULES

       rewrite is an object where keys are regular expressions and values are rewrite rules if
       the expression matches. Rules may contain references to captures of the expression.

       Regular expression and replacement follow ECMA-script rules.

       If no expression matches, the format output is left unchanged.

       Invalid expressions (e.g., mismatched parentheses) are skipped.

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

       •   #taskbar
       •   #taskbar button
       •   #taskbar button.maximized
       •   #taskbar button.minimized
       •   #taskbar button.active
       •   #taskbar button.fullscreen

                                            2023-08-16                      waybar-wlr-taskbar(5)