-
Notifications
You must be signed in to change notification settings - Fork 9
Widgets Taskbar
prankstr edited this page Jun 6, 2026
·
2 revisions
Shows open windows as clickable buttons with app icons. Click a button to focus the corresponding window.
Note
Supports Niri and MangoWC right now.
| Option | Type | Default | Description |
|---|---|---|---|
show_title |
bool | false |
Show window titles next to icons |
show_icon |
bool | true |
Show application icons |
icon_size |
integer | Icon size in pixels. Default: theme pixmap icon size | |
max_windows |
integer | 0 |
Maximum windows to show (0 = unlimited). When the focused window would be cut off, it's swapped into the last visible slot |
show_active |
bool | true |
Highlight the focused window with accent color |
show_workspace_separator |
bool | true |
Show separators between workspaces and outputs |
workspace_separator_label |
string | "none" |
"none" or "number". Shows workspace number in separators |
filter_by_output |
bool | true |
Only show windows on this bar's output |
show_scratchpad_windows |
bool | true |
Show visible MangoWC scratchpad windows. Hidden scratchpads are never shown |
background_color |
string | Custom background color (hex) |
Buttons sort by output → workspace → layout position with optional separators between workspaces (thin, 30% opacity) and outputs (wider, 45% opacity).
| Class | Description |
|---|---|
.taskbar |
Widget container |
.taskbar-button |
Individual window button |
.taskbar-button.active |
Currently focused window (uses accent color) |
.taskbar-separator |
Separator between windows on different workspaces |
.taskbar-separator-label |
Optional workspace number label inside separators |
.taskbar-output-separator |
Separator between windows on different outputs |
Hover colors use the semantic hover variables --color-taskbar-button-hover-bg and --color-taskbar-button-active-hover-bg.