waybar-wlr-taskbar(5) File Formats Manual waybar-wlr-taskbar(5)

# [NAME](#NAME)

waybar - wlr taskbar module

# [DESCRIPTION](#DESCRIPTION)

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

# [CONFIGURATION](#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](#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](#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_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](#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](#Style)

- **#taskbar**
- **#taskbar button**
- **#taskbar button.maximized**
- **#taskbar button.minimized**
- **#taskbar button.active**
- **#taskbar button.fullscreen**

2026-10-17

---

Document: waybar-wlr-taskbar(5) from waybar 0.15.0-r1 (Chainguard OS)