Skip to content

About

Launch, hide, and restore SimpleX Chat from the Omarchy bar.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

3 Commits

Folders and files

Repository files navigation

SimpleX Chat for Omarchy

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.

SimpleX Chat badge with its green running indicator

Install

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 --enable

For another installation path, point the widget at the executable:

omarchy bar set bakugo.simplex appPath /path/to/simplex

If 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/simplex

The 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.

Use

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.

Remove

If SimpleX is hidden, click the badge once to bring the window back before removing the widget.

omarchy plugin remove bakugo.simplex --yes

MIT license.

About

Launch, hide, and restore SimpleX Chat from the Omarchy bar.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages