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/titles to be invisible.
82
83       app_ids-mapping:
84            typeof: object
85            Dictionary of app_id to be replaced with
86

FORMAT REPLACEMENTS

88       {icon}: The icon of the application.
89
90       {title}: The application name as in desktop file if appropriate desktop
91       fils found, otherwise same as {app_id}
92
93       {title}: The title of the application.
94
95       {app_id}: The app_id (== application name) of the application.
96
97       {state}: The state (minimized, maximized, active, fullscreen) of the
98       application.
99
100       {short_state}: The state (minimize == m, maximized == M, active == A,
101       fullscreen == F) represented as one character of the application.
102

CLICK ACTIONS

104       activate: Bring the application into foreground.
105
106       minimize: Toggle application's minimized state.
107
108       minimize-raise: Bring the application into foreground or toggle its
109       minimized state.
110
111       maximize: Toggle application's maximized state.
112
113       fullscreen: Toggle application's fullscreen state.
114
115       close: Close the application.
116

EXAMPLES

118           "wlr/taskbar": {
119                "format": "{icon}",
120                "icon-size": 14,
121                "icon-theme": "Numix-Circle",
122                "tooltip-format": "{title}",
123                "on-click": "activate",
124                "on-click-middle": "close",
125                "ignore-list": [
126                    "Alacritty"
127                ],
128                "app_ids-mapping": {
129                     "firefoxdeveloperedition": "firefox-developer-edition"
130                }
131           }
132

Style

134       •   #taskbar
135       •   #taskbar button
136       •   #taskbar button.maximized
137       •   #taskbar button.minimized
138       •   #taskbar button.active
139       •   #taskbar button.fullscreen
140
141
142
143                                  2023-01-11             waybar-wlr-taskbar(5)