A status bar and notification daemon for sway, written as a single Quickshell (QML) config. It replaces waybar and mako on one desktop, and keeps waybar's look when nothing is happening.
- Bar on every output: workspaces (click or scroll) and the sway mode on the left, the clock in the center (a click shows seconds, hovering opens a calendar), the system tray on the right with menus drawn in QML.
- Notifications (
org.freedesktop.Notifications, spec 1.2): a note grows out of the clock and fills the center of the bar. Waiting notes roll in one after another, long lines scroll, and criticals turn the span red until clicked. Actions, Do Not Disturb, a history of 20 with restore, and fullscreen-aware placement are built in. When you click a notification, bar sends an activation token, so a terminal like kitty marks its window urgent. Screenshot notifications show the picture in a card above the bar, and a right click discards the file. - OSDs for volume, brightness and the microphone take the full width of the bar for a moment (the
x-canonical-private-synchronoushint with anint:value:hint). - Tray: bar is the
org.kde.StatusNotifierWatcherand the host. - Themes: base16 Default Dark and Light, switched live by darkman with a 300 ms crossfade. The bar never unmaps, so windows don't re-tile.
It's built for one laptop (1920x1200 at scale 2, Fedora), so expect to adjust things. docs/SPEC.md describes every behavior.
- sway 1.11
- Quickshell. bar is tested against Fedora's snapshot
0.2.1^git20260209.dacfa9don Qt 6.11, and newer Quickshell releases may differ. - The IosevkaTerm Nerd Font, and the AdwaitaLegacy icon theme for tray icons
- darkman (optional), for the theme switch
docs/PLAN.md section 6 has the full cutover and rollback steps. In short:
make installcopies the tagged, committed HEAD to~/.local/share/bar, with file watching turned off.DEST=/abs/pathinstalls elsewhere.- Copy
packaging/bar.serviceto~/.config/systemd/user/, then runsystemctl --user enable --now bar.service. The unit starts undersway-session.target. - Copy
packaging/org.freedesktop.Notifications.serviceto~/.local/share/dbus-1/services/. Edit the absolute path in it first, since D-Bus files don't expand%h. - Stop waybar and mako. Comment out sway's
bar {}block, so that a reload doesn't bring waybar back. - Optional: add
packaging/sway-bindings.confto your sway config (dismiss, dismiss all, restore, toggle DND), and installpackaging/darkman-bar.shas an executable darkman hook.
quickshell ipc -p ~/.local/share/bar call notify dismiss # also: dismissAll, restore, toggleDnd, setDnd, invoke, status
quickshell ipc -p ~/.local/share/bar call theme set light # or darkEvery test runs in an isolated nested sway session (headless outputs, a private D-Bus, Quickshell on this tree), never against the live desktop.
make nested # start the nested session; make nested-stop ends it
make matrix # the docs/SPEC.md test matrix, about 10 minutes; CASE=N5 runs one case
make test # unit tests for services/Rules.js and services/Markup.js (node)
make lint # qmllint (needs qt6-qtdeclarative-devel)docs/SPEC.md: what bar does.docs/PLAN.md: the milestones, the test harness, decisions, and the findings with evidence.CLAUDE.md: instructions and gotchas for coding agents working on the tree.
MIT, see LICENSE.