Skip to content

Workspaces

Jake Stanger edited this page Oct 28, 2022 · 19 revisions

This module is currently only supported on Sway

Shows all current Sway workspaces. Clicking a workspace changes focus to it.

Screenshot showing workspaces widget using custom icons with browser workspace focused

Configuration

Type: workspaces

Name Type Default Description
name_map Map<string, string> {} A map of actual workspace names to their display labels. Workspaces use their actual name if not present in the map.
all_monitors boolean false Whether to display workspaces from all monitors. When false, only shows workspaces on the current monitor.
JSON
{
  "end": [
    {
      "type": "workspaces",
      "name_map": {
        "1": "",
        "2": "",
        "3": ""
      },
      "all_monitors": false
    }
  ]
}
TOML
[[end]]
type = "workspaces"
all_monitors = false

[[end.name_map]]
1 = ""
2 = ""
3 = ""
YAML
end:
  - type: "workspaces"
    name_map:
      1: ""
      2: ""
      3: ""
    all_monitors: false
Corn
{
  end = [
    {
      type = "workspaces",
      name_map.1 = ""
      name_map.2 = ""
      name_map.3 = ""
      all_monitors = false
    }
  ]
}

Styling

Selector Description
#workspaces Workspaces widget box
#workspaces .item Workspace button
#workspaces .item.focused Workspace button (workspace focused)
Clone this wiki locally