Man page - waybar-wlr-taskbar(5)

Packages contains this manual

Package:  waybar
apt-get install waybar

Manuals in package:
• waybar-backlight-slider(5)
• waybar-river-layout(5)
• waybar-sway-scratchpad(5)
• waybar-pulseaudio-slider(5)
• waybar-hyprland-submap(5)
• waybar-river-mode(5)
• waybar-keyboard-state(5)
• waybar-cffi(5)
• waybar-pulseaudio(5)
• waybar-states(5)
• waybar-clock(5)
• waybar(5)
• waybar-dwl-tags(5)
• waybar-niri-window(5)
• waybar-niri-workspaces(5)
• waybar-dwl-window(5)
• waybar-sndio(5)
• waybar-niri-language(5)
• waybar-hyprland-language(5)
• waybar-wireplumber(5)
• waybar-mpris(5)
• waybar-gamemode(5)
• waybar-sway-language(5)
• waybar-hyprland-workspaces(5)
• waybar-power-profiles-daemon(5)
• waybar-battery(5)
• waybar-wlr-taskbar(5)
• waybar-tray(5)
• waybar-menu(5)
• waybar-sway-workspaces(5)
• waybar-styles(5)
• waybar-sway-mode(5)
• waybar-cpu(5)
• waybar-river-window(5)
• waybar-mpd(5)
• waybar-hyprland-window(5)
• waybar-sway-window(5)
• waybar-network(5)
• waybar-systemd-failed-units(5)
• waybar-jack(5)
• waybar-temperature(5)
• waybar-river-tags(5)
• waybar-custom(5)
• waybar-idle-inhibitor(5)
• waybar-bluetooth(5)
• waybar-privacy(5)
• waybar-backlight(5)
• waybar-inhibitor(5)
• waybar-image(5)
• waybar-upower(5)
• waybar-disk(5)
• waybar-memory(5)
Documentations in package:
• waybar

Manual

waybar-wlr-taskbar

NAME
DESCRIPTION
CONFIGURATION
FORMAT REPLACEMENTS
CLICK ACTIONS
REWRITE RULES
EXAMPLES
Style

---

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

---