1waybar-wlr-taskbar(5)         File Formats Manual        waybar-wlr-taskbar(5)
2
3
4

NAME

6       wlroots - Taskbar module
7

DESCRIPTION

9       The taskbar module displays the currently open applications. This mod‐
10       ule requires a compositor that implements the foreign-toplevel-manager
11       interface.
12

CONFIGURATION

14       Addressed by wlr/taskbar
15
16       all-outputs:
17            typeof: bool
18            default: false
19            If set to false applications on the waybar's current output will
20       be shown. Otherwise all applications are shown.
21
22       format:
23            typeof: string
24            default: {icon}
25            The format, how information should be displayed.
26
27       icon-theme:
28            typeof: array|string
29            The names of the icon-themes that should be used to find an icon.
30       The list will be traversed from left to right. If omitted, the system
31       default will be used.
32
33       icon-size:
34            typeof: integer
35            default: 16
36            The size of the icon.
37
38       markup:
39            typeof: bool
40            default: false
41            If set to true, pango markup will be accepted in format and
42       tooltip-format.
43
44       tooltip:
45            typeof: bool
46            default: true
47            If set to false no tooltip will be shown.
48
49       tooltip-format:
50            typeof: string
51            default: {title}
52            The format, how information in the tooltip should be displayed.
53
54       active-first:
55            typeof: bool
56            default: false
57            If set to true, always reorder the tasks in the taskbar so that
58       the currently active one is first. Otherwise don't reorder.
59
60       on-click:
61            typeof: string
62            The action which should be triggered when clicking on the applica‐
63       tion button with the left mouse button.
64
65       on-click-middle:
66            typeof: string
67            The action which should be triggered when clicking on the applica‐
68       tion button with the middle mouse button.
69
70       on-click-right:
71            typeof: string
72            The action which should be triggered when clicking on the applica‐
73       tion button with the right mouse button.
74
75       on-update:
76            typeof: string
77            Command to execute when the module is updated.
78
79       ignore-list:
80            typeof: array
81            List of app_id to be invisible.
82

FORMAT REPLACEMENTS

84       {icon}: The icon of the application.
85
86       {title}: The title of the application.
87
88       {app_id}: The app_id (== application name) of the application.
89
90       {state}: The state (minimized, maximized, active, fullscreen) of the
91       application.
92
93       {short_state}: The state (minimize == m, maximized == M, active == A,
94       fullscreen == F) represented as one character of the application.
95

CLICK ACTIONS

97       activate: Bring the application into foreground. minimize: Toggle ap‐
98       plication's minimized state. minimize-raise: Bring the application into
99       foreground or toggle its minimized state. maximize: Toggle applica‐
100       tion's maximized state. fullscreen: Toggle application's fullscreen
101       state. close: Close the application.
102

EXAMPLES

104           "wlr/taskbar": {
105                "format": "{icon}",
106                "icon-size": 14,
107                "icon-theme": "Numix-Circle",
108                "tooltip-format": "{title}",
109                "on-click": "activate",
110                "on-click-middle": "close",
111                "ignore-list": [
112                    "Alacritty"
113                ]
114           }
115

Style

117       •   #taskbar
118       •   #taskbar button
119       •   #taskbar button.maximized
120       •   #taskbar button.minimized
121       •   #taskbar button.active
122       •   #taskbar button.fullscreen
123
124
125
126                                  2021-11-02             waybar-wlr-taskbar(5)