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

NAME
       waybar - sway workspaces module

DESCRIPTION
       The workspaces module displays the currently used workspaces in Sway.

CONFIGURATION
       Addressed by sway/workspaces

       all-outputs:
            typeof: bool
            default: false
            If set to false, workspaces will only be shown on the output they
       are on. If set to true all workspaces will be shown on every output.

       format:
            typeof: string
            default: {value}
            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.

       disable-scroll:
            typeof: bool
            default: false
            If set to false, you can scroll to cycle through workspaces. If
       set to true this behaviour is disabled.

       disable-click:
            typeof: bool
            default: false
            If set to false, you can click to change workspace. If set to true
       this behaviour is disabled.

       smooth-scrolling-threshold:
            typeof: double
            Threshold to be used when scrolling.

       disable-scroll-wraparound:
            typeof: bool
            default: false
            If set to false, scrolling on the workspace indicator will wrap
       around to the first workspace when reading the end, and vice versa. If
       set to true this behavior is disabled.

       enable-bar-scroll:
            typeof: bool
            default: false
            If set to false, you can't scroll to cycle throughout workspaces
       from the entire bar. If set to true this behaviour is enabled.

       disable-markup:
            typeof: bool
            default: false
            If set to true, button label will escape pango markup.

       current-only:
            typeof: bool
            default: false
            If set to true. Only focused workspaces will be shown.

       persistent-workspaces:
            typeof: json (see below)
            default: empty
            Lists workspaces that should always be shown, even when non-
       existent

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

       disable-auto-back-and-forth:
            typeof: bool
            Whether to disable workspace_auto_back_and_forth when clicking on
       workspaces. If this is set to true, clicking on a workspace you are
       already on won't do anything, even if workspace_auto_back_and_forth is
       enabled in the Sway configuration.

       alphabetical_sort:
            typeof: bool
            Whether to sort workspaces alphabetically. Please note this can
       make "swaymsg workspace prev/next" move to workspaces inconsistent with
       the ordering shown in Waybar.

       warp-on-scroll:
            typeof: bool
            default: true
            If set to false, you can scroll to cycle through workspaces
       without mouse warping being enabled. If set to true this behaviour is
       disabled.

       window-rewrite:
            typeof: object
            Regex rules to map window class to an icon or preferred method of
       representation for a workspace's window.
           Keys are the rules, while the values are the methods of
           representation. Rules may specify `class<...>`, `title<...>`, or
           both in order to fine-tune the matching.

       window-rewrite-default:
           typeof: string
                default: "?"
                The default method of representation for a workspace's window.
           This will be used for windows whose classes do not match any of the
           rules in window-rewrite.

       format-window-separator:
            typeof: string
            default: " "
            The separator to be used between windows in a workspace.

FORMAT REPLACEMENTS
       {value}: Name of the workspace, as defined by sway.

       {name}: Number stripped from workspace value.

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

       {index}: Index of the workspace.

       {output}: Output where the workspace is located.

       {windows}: Result from window-rewrite

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

       o   default: Will be shown, when no string matches are found.
       o   urgent: Will be shown, when workspace is flagged as urgent
       o   focused: Will be shown, when workspace is focused
       o   persistent: Will be shown, when workspace is persistent.
       o   high-priority-named: Icons by names will be shown always for those
           workspaces, independent by state.

PERSISTENT WORKSPACES
       Each entry of persistent_workspace names a workspace that should always
       be shown. Associated with that value is a list of outputs indicating
       where the workspace should be shown, an empty list denoting all
       outputs.

           "sway/workspaces": {
                "persistent-workspaces": {
                     "3": [], // Always show a workspace with name '3', on all outputs if it does not exist
                     "4": ["eDP-1"], // Always show a workspace with name '4', on output 'eDP-1' if it does not exist
                     "5": ["eDP-1", "DP-2"] // Always show a workspace with name '5', on outputs 'eDP-1' and 'DP-2' if it does not exist
                }
           }

       n.b.: the list of outputs can be obtained from command line using
       swaymsg -t get_outputs

EXAMPLES
           "sway/workspaces": {
                "disable-scroll": true,
                "all-outputs": true,
                "format": "{name}: {icon}",
                "format-icons": {
                     "1": "<?>",
                     "2": "<?>",
                     "3": "<?>",
                     "4": "<?>",
                     "5": "<?>",
                     "high-priority-named": [ "1", "2" ],
                     "urgent": "<?>",
                     "focused": "<?>",
                     "default": "<?>"
                }
           }

           "sway/workspaces": {
             "format": "<span size='larger'>{name}</span> {windows}",
             "format-window-separator": " | ",
             "window-rewrite-default": "{name}",
             "window-format": "<span color='#e0e0e0'>{name}</span>",
             "window-rewrite": {
               "class<firefox>": "<?>",
               "class<kitty>": "k",
             }
           }

Style
       o   #workspaces button
       o   #workspaces button.visible
       o   #workspaces button.focused
       o   #workspaces button.urgent
       o   #workspaces button.persistent
       o   #workspaces button.empty
       o   #workspaces button.current_output
       o   #workspaces button#sway-workspace-${name}

                                  2024-05-06         waybar-sway-workspaces(5)