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

NAME
       waybar - wlr workspaces module

DESCRIPTION
       The workspaces module displays the currently used workspaces in wayland
       compositor.

CONFIGURATION
       Addressed by wlr/workspaces

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

       format-icons:
            typeof: array
            Based on the workspace name and state, the corresponding icon gets
       selected. See icons.

       sort-by-name:
            typeof: bool
            default: true
            Should workspaces be sorted by name.

       sort-by-coordinates:
            typeof: bool
            default: true
            Should workspaces be sorted by coordinates.
            Note that if both  sort-by-name and sort-by-coordinates are true
       sort-by name will be first. If both are false - sort by id will be
       performed.

       sort-by-number:
            typeof: bool
            default: false
            If set to true, workspace names will be sorted numerically. Takes
       precedence over any other sort-by option.

       all-outputs:
            typeof: bool
            default: false
            If set to false workspaces group will be shown only in assigned
       output. Otherwise, all workspace groups are shown.

       active-only:
            typeof: bool
            default: false
            If set to true only active or urgent workspaces will be shown.

FORMAT REPLACEMENTS
       {name}: Name of workspace assigned by compositor

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

CLICK ACTIONS
       activate: Switch to workspace.

       close: Close the workspace.

ICONS
       In addition to workspace name matching, the following format-icons can
       be set.

       o   default: Will be shown, when no string match is found.
       o   active: Will be shown, when workspace is active

EXAMPLES
           "wlr/workspaces": {
                "format": "{name}: {icon}",
                "format-icons": {
                     "1": "<?>",
                     "2": "<?>",
                     "3": "<?>",
                     "4": "<?>",
                     "5": "<?>",
                     "active": "<?>",
                     "default": "<?>"
                },
                "sort-by-number": true
           }

Style
       o   #workspaces
       o   #workspaces button
       o   #workspaces button.active
       o   #workspaces button.urgent
       o   #workspaces button.hidden

                                  2024-09-15          waybar-wlr-workspaces(5)