Module: Taskbar

The wlr/taskbar module can be used to add a taskbar based on the foreign-toplevel-manager protocol. For this module to work, you need a wayland compositor that implements the protocol.

Config

option	typeof	default	description
all-outputs	bool	false	If set to false only applications on waybar's current output will be shown. Otherwise all applications will be shown.
format	string	{icon}	The format, how information should be displayed for applications.
icon-theme	string		The name of the icon-theme that should be used. If omitted, the system default will be used.
icon-size	int	16	The size in pixels for the icon.
markup	bool	false	If set to true pango markup will be allowed in format/tooltip_format.
tooltip	bool	true	If set to false no tooltip will be shown.
tooltip-format	string	{title}	The format, how information in the tooltip should be displayed for applications.
active-first	bool	false	If set to true, always reorder the tasks in the taskbar so that the currently active one is first. Otherwise don't reorder.
on-click	string		The action which should be triggered when clicking on the applications button in the taskbar with the left mouse button.
on-click-middle	string		The action which should be triggered when clicking on the applications button in the taskbar with the middle mouse button.
on-click-right	string		The action which should be triggered when clicking on the applications button in the taskbar with the right mouse button.
on-update	string		Command to execute when the module is updated.

Format replacements:

string	replacement
{icon}	The icon of the application.
{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 represented as one character (minimized == m, maximized == M, active == A, fullscreen == F) of the application.

Note: Like all format replacements in waybar, {title:.15} places a length limit of 15 bytes on the replaced title string. This may result in invalid text if a multi-byte character is present or (if markup is true) if the text includes values that must be escaped in XML.

Actions:

string	action
activate	Bring the application into foreground.
minimize	Minimize the application.
maximize	Maximize the application.
fullscreen	Set the application to fullscreen.
close	Close the application.

Example:

"wlr/taskbar": {
    "format": "{icon}",
    "icon-size": 14,
    "icon-theme": "Numix-Circle",
    "tooltip-format": "{title}",
    "on-click": "activate",
    "on-click-middle": "close"
}

Style

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