Add Flex Taskbar plugin - #296
Draft
sudiptacmd wants to merge 2 commits into
Draft
Conversation
spiros132
force-pushed
the
main
branch
5 times, most recently
from
August 7, 2026 22:57
8d53319 to
d59cdac
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Plugin
sudiptacmd/flex-taskbarplugin.toml)What it does
Adds a configurable Niri taskbar to the Noctalia bar. It supports pinned and unpinned running apps, grouped windows, one indicator dot per window, a focused-window dot and underline, focus/cycle/launch interactions, output filtering, full visual customization, and clickable window thumbnails on hover.
Icons default to 100% opacity in every state, and the per-item hover background defaults to transparent.
External dependencies
niri: query windows/workspaces, focus windows, and capture preview thumbnails.gtk-launch: launch pinned desktop-file IDs without a custom command.wl-copyandwl-paste: preserve and restore clipboard data around Niri's screenshot action.head: select the first available clipboard MIME type.rm: remove the temporary clipboard backup.There are no network calls. Preview PNGs and a temporary clipboard backup are written only under
noctalia.pluginDataDir().Testing
Validated locally with:
noctalia plugins lint flex-taskbar— 0 errors, 0 warnings.python3 .github/workflows/scripts/validate-plugins.py— 77 manifests validated.python3 -m unittest discover -s .github/workflows/scripts -p 'test_*.py'— 56 tests passed.Screenshots / Videos
Running taskbar:
Store thumbnail:
Checklist
idafter the/inplugin.tomlexactly.plugin.toml,README.md,thumbnail.webp, andtranslations/en.json.README.mdfollows theREADME template, documents
every entry id and dependency, and includes exact panel IPC commands and launcher prefixes where applicable.
thumbnail.webpwith the thumbnail generator.versionfollows semver and is bumped in this PR;plugin_apiis the oldest API level this plugin requires.understand that language well enough to review and maintain it (no unreviewed machine/LLM translations).
catalog.toml; CI generates it.Code review attestation
Plugins run as trusted, unsandboxed Luau in the user's session. Confirm:
licensedeclared inplugin.toml.