History / Bar Plugins

Document what 0.2.9.4 added, and fix what it made wrong New page: **Welcome Guide** — Super+Escape, the six pages, synui-welcome's verbs, the live key column, turning it off, and why it is a process of its own rather than a window in the bar. Linked from Home and the sidebar. Corrected, because these were stale rather than merely thin: - Keybindings: Super+Escape was documented as "Menu". Super+/ is a hotkey MANAGER now — unbound actions and installed applications, not only what already has a chord. Theme count was thirteen and is fifteen; Prism and Prism Light, which is what a fresh install actually boots into, were not in the list. - Bar Plugins: the two headline numbers were both wrong. qs.Ui is 27 implemented types, not two — and that matters, because a QML property that does not resolve is zero, so a widget written against the fuller module went on, reported itself enabled and drew nothing (9 of 40 community widgets resolved before, 39 do now). `browse` reaches around nine hundred widgets from the community registry, not the five shipped here. Plus refresh/order/check, panels and services being hosted once per session, and the bar menu's own Plugins section. - Gaming: MANGOHUD=1 is no longer exported for the session, with the reason — the layer segfaults Vulkan clients on AMD and never on NVIDIA, so it is a crash that follows the graphics card rather than the program. `syn game` is the launcher throughout. A GeForce NOW section: what the Electron client cannot do, measured, and why the browser is the client. - Big Screen: the Recent bar (the DESKTOP's list, kept by the compositor at the one moment every launch has in common), the wheel, the GFN tile. - The Desktop: nine widgets, not four — the analog clock and its four faces, and the music card. And the font is one setting for the whole desktop with fifteen typefaces shipped to pick from. - Settings: naming the machine. Every install answers to `synapse`, so two on one network and Avahi renames one with no say in which. - Commands: synui-welcome, syn-gfn, `syn game`, `synctl binds`, `synctl recent`, synui-plugins' refresh/order/check. - Troubleshooting: "MangoHud never appears" had one reason and now has two, the new one first. Checked: synui/tests/readme_binds.sh passes against Keybindings.md (73 default binds), and no internal wiki link is broken.

velle999 committed Aug 26, 2026

RGB lighting, and the plugin manager's other two faces syn-rgb was documented nowhere — not in the wiki, not in the README, not on the site — despite being on by default on a fresh install and having a control-panel row. It has a section in The Desktop now: what it is (a bridge, not a daemon — the watching is a systemd path unit), that openrgb is an optdepend and it names the missing package rather than failing silently, and that a greyscale wallpaper is an answer rather than a failure. Bar Plugins gains the window and the terminal browser, and Commands says so.

velle999 committed Aug 24, 2026

Bar Plugins: Omarchy's own widgets run now 468 shipped the format and refused anything reaching past BarWidget. qs.Commons and WidgetButton are provided now — measured rather than guessed: across their eight shipped bar widgets the whole Commons surface is eleven Style properties, two Color and two Util, and five of the eight fail on WidgetButton alone. Five of their eight run. The page says which, and which two are refused for Hyprland, and why the Commons shim maps onto synui's theme rather than vendoring theirs (legal, MIT — but it would drag their palette across). Adds browse/add/remove.

velle999 committed Aug 24, 2026

Bar, dock, Prism and plugins — and 7 binds the drift test was failing on The wiki was 68 commits behind. This is the part of that gap that could be written correctly rather than guessed at. Keybindings: the 7 binds synui/tests/readme_binds.sh was failing on — the bare Super+arrow window moves (they lost their Shift in synui 438), the two Super+Ctrl+arrow fill toggles, and Super+Shift+I for the image viewer. The page passes that test again. New page — The Dock. It had no coverage at all: 20 config keys, both right-click menus, pins, the three cells, edges, magnify and the radius clamp. Notes that an app's own rows are at the BOTTOM of an icon's menu now (synui 463) and why. New page — Bar Plugins. synui 464 takes third-party bar widgets in Omarchy's shell-plugin format. Covers the manifest, the BarWidget contract, where they are searched (Omarchy's own directory first) and — at length — what SynapseOS cannot host, because a plugin system whose answer to "needs Hyprland" is an empty space on the bar is one nobody can debug. The Desktop: thirteen themes became fifteen. Prism and Prism Light were the default theme for two releases and were documented nowhere — the only "Prism" in the whole wiki was the game launcher. Adds what Prism actually is (the wallpaper supplies the colour, everything else is fixed), the glass system as a table of its seven keys, and what a fresh install ships since 0.2.9.4 — including that glass_level = 100 is an explicit number that survives a theme switch, and the one row that undoes it. Software: the All sources tab, `synpkg search --all`, and row icons. Commands: synui-plugins and syn-rgb, neither of which was named anywhere. Installation: "0.2.5, the current release" was four releases stale. Rewritten as a since-then statement so it cannot go stale again.

velle999 committed Aug 24, 2026