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

FORMAT REPLACEMENTS

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

CLICK ACTIONS

93       activate: Bring the application into foreground. minimize: Toggle ap‐
94       plication's minimized state. minimize-raise: Bring the application into
95       foreground or toggle its minimized state. maximize: Toggle applica‐
96       tion's maximized state. fullscreen: Toggle application's fullscreen
97       state. close: Close the application.
98

EXAMPLES

100           "wlr/taskbar": {
101                "format": "{icon}",
102                "icon-size": 14,
103                "icon-theme": "Numix-Circle",
104                "tooltip-format": "{title}",
105                "on-click": "activate",
106                "on-click-middle": "close"
107           }
108

Style

110       •   #taskbar
111       •   #taskbar button
112       •   #taskbar button.maximized
113       •   #taskbar button.minimized
114       •   #taskbar button.active
115       •   #taskbar button.fullscreen
116
117
118
119                                  2021-04-15             waybar-wlr-taskbar(5)