Keep SimpleX Chat one click away on Wayland. The bar badge launches the desktop app, moves its window to a hidden Hyprland workspace, or brings it back to the workspace you're using. The green ring shows that the desktop window is running, even when hidden.
Requires Omarchy 4.x with Quickshell, Hyprland 0.55 or later, hyprctl, jq, setsid, timeout, and the SimpleX Chat desktop app. The widget looks for simplex-desktop on your PATH, then falls back to ~/simplex.
omarchy plugin add https://github.com/CallMeBakugo/omarchy-simplex.git --enableFor another installation path, point the widget at the executable:
omarchy bar set bakugo.simplex appPath /path/to/simplexIf appPath is a custom wrapper script, set appExecutable to the native SimpleX binary it launches. The standard Arch wrapper is handled automatically.
omarchy bar set bakugo.simplex appExecutable /path/to/native/simplexThe badge and toggle both require the window class to match and the compositor-reported process to be running that executable. If the process cannot be verified, the widget leaves the window alone.
If the package uses a different Hyprland window class, set windowClass. The default is chat-simplex-desktop-MainKt.
Left-click to launch, hide, or restore the window. Right-click to refresh its running state. Hidden windows stay on special:simplex, so SimpleX can continue receiving messages. The widget reads compositor window state and does not read messages.
If SimpleX is hidden, click the badge once to bring the window back before removing the widget.
omarchy plugin remove bakugo.simplex --yes