mango-workspaces

MangoWM tag switcher module configuration.

Add it to your layout with mango-workspaces:

bar:
  layout:
    - monitor: "*"
      right: [mango-workspaces]

General

Field	Type	Default	Description
hide-empty	bool	true	Hide tags that hold no clients and are not active.
min-tag-count	u8	0	Always show tags up to this one-based index, even when empty.
display-mode	DisplayMode	"label"	What identifies each tag: its label, an icon, or nothing.
divider	string	" "	Text shown between the tag label and its application icons.
app-icons-show	bool	false	Show an application icon per client on each tag.
app-icons-dedupe	bool	true	Collapse clients that share an application to a single icon.
app-icons-fallback	string	"ld-app-window-symbolic"	Icon for clients not matched by app-icon-map.
app-icons-empty	string	"ld-minus-symbolic"	Icon shown when a tag has no clients.
urgent-show	bool	true	Highlight tags whose clients requested attention.
urgent-mode	UrgentMode	"workspace"	Whether urgency is tracked per tag or per application.
active-indicator	ActiveIndicator	"background"	How the active tag is marked.
tag-padding	Size	0.5	Padding around each tag button, in rem.
icon-gap	Size	0.3	Spacing between application icons. Accepts a scale multiplier or pixels (e.g. "4px").
icon-size	Size	1	Application icon size. Accepts a scale multiplier or pixels (e.g. "16px").
label-size	Size	1	Tag label text size. Accepts a scale multiplier or pixels (e.g. "16px").
active-color	ColorValue	"accent"	Color of the active tag.
occupied-color	ColorValue	"fg-muted"	Color of tags that hold clients but are not active.
empty-color	ColorValue	"fg-subtle"	Color of empty tags.
container-bg-color	ColorValue	"bg-surface-elevated"	Background color of the tag container.
border-show	bool	false	Draw a border around the tag container.
border-color	ColorValue	"border-default"	Border color when the border is shown.
app-icon-map	map of string	{}	Window-to-icon mappings for the application icons.
tag-map	map of WorkspaceStyle	{}	Per-tag icon and color overrides, keyed by one-based tag index.
left-click	WorkspaceClickAction	"focus:this"	Action for a left click on a tag.
middle-click	WorkspaceClickAction	""	Action for a middle click on a tag.
right-click	WorkspaceClickAction	""	Action for a right click on a tag.
scroll-up	WorkspaceClickAction	"focus:previous"	Action for scrolling up over the tag container.
scroll-down	WorkspaceClickAction	"focus:next"	Action for scrolling down over the tag container.

More about min-tag-count

0 shows only occupied or active tags (subject to hide-empty). A value above the compositor's tag count just shows every tag.

More about app-icon-map

Keys are glob patterns matched against a client's app id, or title: patterns matched against its title. Values are symbolic icon names.

Example

modules:
  mango-workspaces:
    app-icon-map:
      "*firefox*": ld-globe-symbolic
      "title:*YouTube*": si-youtube-symbolic

More about tag-map

Example

modules:
  mango-workspaces:
    tag-map:
      "1":
        label: web
        icon: ld-globe-symbolic
        color: "#4a90d9"
      "2":
        label: term
        icon: ld-terminal-symbolic

Default configuration

modules:
  mango-workspaces:
    hide-empty: true
    min-tag-count: 0
    display-mode: label
    divider: ' '
    app-icons-show: false
    app-icons-dedupe: true
    app-icons-fallback: ld-app-window-symbolic
    app-icons-empty: ld-minus-symbolic
    urgent-show: true
    urgent-mode: workspace
    active-indicator: background
    tag-padding: 0.5
    icon-gap: 0.30000001192092896
    icon-size: 1.0
    label-size: 1.0
    active-color: accent
    occupied-color: fg-muted
    empty-color: fg-subtle
    container-bg-color: bg-surface-elevated
    border-show: false
    border-color: border-default
    app-icon-map: {}
    tag-map: {}
    left-click: focus:this
    middle-click: ""
    right-click: ""
    scroll-up: focus:previous
    scroll-down: focus:next