waybar-wlr-taskbar - Man Page

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

Format Replacements

{icon}: The icon of the application.

{title}: The application name as in desktop file if appropriate desktop fils 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.

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"
  	}
  }

Style

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

Referenced By

waybar(5).

2023-05-29