ironbar/docs/modules/Workspaces.md
Jake Stanger 2da28b9bf5
feat: ability to configure image icon sizes
Adds `icon_size` option to following widgets:

- `clipboard`
- `launcher`
- `music`
- `workspaces`

Also adds `cover_image_size` option to `music`.
2023-04-22 22:22:49 +01:00

2.9 KiB

This module is currently only supported on Sway and Hyprland

Shows all current 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/image> {} A map of actual workspace names to their display labels/images. Workspaces use their actual name if not present in the map. See here for information on images.
icon_size integer 32 Size to render icon at (image icons only).
all_monitors boolean false Whether to display workspaces from all monitors. When false, only shows workspaces on the current monitor.
sort added or alphanumeric alphanumeric The method used for sorting workspaces. added always appends to the end, alphanumeric sorts by number/name.
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)