---
name: "waybar-wlr-taskbar"
section: "5"
platform: "linux"
package: "waybar"
version: "0.15.0-3"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/waybar-wlr-taskbar"
---

# waybar-wlr-taskbar(5)

wlr taskbar module

## NAME

waybar - wlr taskbar module

## DESCRIPTION

The **taskbar** module displays the currently open applications. This module requires a compositor that implements the foreign-toplevel-manager interface.

## CONFIGURATION

Addressed by **wlr/taskbar**

**all-outputs**: \
 typeof: bool \
 default: false \
 If set to false applications on the waybar's current output will be shown. Otherwise, all applications are shown.

**format**: \
 typeof: string \
 default: {icon} \
 The format, how information should be displayed.

**icon-theme**: \
 typeof: array\|string \
 The names of the icon-themes that should be used to find an icon. The list will be traversed from left to right. If omitted, the system default will be used.

**icon-size**: \
 typeof: integer \
 default: 16 \
 The size of the icon.

**markup**: \
 typeof: bool \
 default: false \
 If set to true, pango markup will be accepted in format and tooltip-format.

**tooltip**: \
 typeof: bool \
 default: true \
 If set to false no tooltip will be shown.

**tooltip-format**: \
 typeof: string \
 default: {title} \
 The format, how information in the tooltip should be displayed.

**active-first**: \
 typeof: bool \
 default: false \
 If set to true, always reorder the tasks in the taskbar so that the currently active one is first. Otherwise don't reorder.

**sort-by-app-id**: \
 typeof: bool \
 default: false \
 If set to true, group tasks by their app\_id. Cannot be used with 'active-first'.

**on-click**: \
 typeof: string \
 The action which should be triggered when clicking on the application button with the left mouse button.

**on-click-middle**: \
 typeof: string \
 The action which should be triggered when clicking on the application button with the middle mouse button.

**on-click-right**: \
 typeof: string \
 The action which should be triggered when clicking on the application button with the right mouse button.

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

**ignore-list**: \
 typeof: array \
 List of app\_id/titles to be invisible.

**app\_ids-mapping**: \
 typeof: object \
 Dictionary of app\_id to be replaced with

**rewrite**: \
 typeof: object \
 Rules to rewrite the module format output. See **rewrite rules**.

## FORMAT REPLACEMENTS

**{icon}**: The icon of the application.

**{name}**: The application name as in desktop file if appropriate desktop files are found, otherwise same as {app\_id}

**{title}**: The title of the application.

**{app\_id}**: The app\_id (== application name) of the application.

**{state}**: The state (minimized, maximized, active, fullscreen) of the application.

**{short\_state}**: The state (minimize == m, maximized == M, active == A, fullscreen == F) represented as one character of the application.

## CLICK ACTIONS

**activate**: Bring the application into foreground.

**minimize**: Toggle application's minimized state.

**minimize-raise**: Bring the application into foreground or toggle its minimized state.

**maximize**: Toggle application's maximized state.

**fullscreen**: Toggle application's fullscreen state.

**close**: Close the application.

## REWRITE RULES

**rewrite** is an object where keys are regular expressions and values are rewrite rules if the expression matches. Rules may contain references to captures of the expression.

Regular expression and replacement follow ECMA-script rules.

If no expression matches, the format output is left unchanged.

Invalid expressions (e.g., mismatched parentheses) are skipped.

## EXAMPLES

```
"wlr/taskbar": {
	"format": "{icon}",
	"icon-size": 14,
	"icon-theme": "Numix-Circle",
	"tooltip-format": "{title}",
	"on-click": "activate",
	"on-click-middle": "close",
	"ignore-list": [
	    "Alacritty"
	],
	"app_ids-mapping": {
		"firefoxdeveloperedition": "firefox-developer-edition"
	},
	"rewrite": {
		"Firefox Web Browser": "Firefox",
		"Foot Server": "Terminal"
	}
}
```

## Style

- •

  **#taskbar**

- •

  **#taskbar button**

- •

  **#taskbar button.maximized**

- •

  **#taskbar button.minimized**

- •

  **#taskbar button.active**

- •

  **#taskbar button.fullscreen**