An integrated desktop suite for Omarchy.
A cohesive set of native Omarchy plugins that changes how the desktop looks, feels and works, without replacing the shell underneath it.
 |
 |
 |
One desktop, three themes: the bar, notch and frame follow whichever Omarchy theme you pick.
Ruixen runs as plugins inside the Omarchy shell you already use. A bar, a notch dashboard, a launcher, a settings app and a handful of small tools share one look and one set of behaviors, so they feel like a single desktop instead of a pile of widgets.
It is not a replacement shell, not just a theme, and not a random plugin pack. Turn any piece off, or go back to stock Omarchy in one command.
A bar of floating glass pills (or one docked strip flush with the frame) wraps the screen in a matching frame, black or following your theme. In the middle, the notch expands into a dashboard: music, calendar, notifications, quick toggles, volume, wallpapers with a theme switcher, system health, and a Kanban board.
Floating bar |
Docked bar |
Notch dashboard |
The notch also holds a three-column Kanban board that you and your coding agent can both drive from a keybind or a script.
A Raycast/Spotlight-style palette on real compositor blur. Search Omarchy actions and installed apps, search files by name and contents across every drive with live previews, browse Clipboard History, and browse, preview and install community themes from the bjarneo collection.
Search Files: names and contents, with previews |
Clipboard History |
Theme browser |
The palette: actions, apps and extensions |
Profile, bar layout, window look, audio, Wi-Fi, Bluetooth, display, night light and plugins, in the same overlay as the launcher.
Drag files in from any app, drag them back out into another app or a terminal. The Shelf grows out of the frame at the notch, only remembers paths (it never copies or moves anything), and is readable and writable by your coding agent.
- Kanban in the notch: a three-column board you and an agent can both drive.
- Wallpapers, including muted looping video, and an audio visualizer.
- Plugin pinning: install any Omarchy bar widget, pin it from the bar, no config editing.
- Peripherals: battery levels for wireless mice, keyboards, headsets and controllers.
- Window look: rounded corners and blur to match the frame, or stock square.
Everything is controllable from a keybind, a script or an agent through
omarchy-shell: see Control.
git clone https://github.com/gitcoder89431/ruixen-shell.git
cd ruixen-shell
./install.shWant to see what it will do first? ./install.sh --dry-run changes nothing.
The installer backs up what it replaces, merges into your existing
shell.json instead of overwriting it, and restarts the Omarchy shell.
Details, updating and uninstalling: Installation.
Nothing opens the launcher out of the box, because the installer doesn't touch your Hyprland config unless you ask. To install the recommended keys that are still free:
./install.sh --with-launcher-keybind| Key | Opens |
|---|---|
SUPER+R |
Ruixen Launcher |
SUPER+SHIFT+R |
Ruixen Settings |
SUPER+CTRL+SPACE |
Wallpapers picker |
SUPER+D |
Shelf |
Or bind your own: see Keybinds. Then take the manual for a tour.
| I want to... | Go to |
|---|---|
| Find my way around | Manual index |
| Install, update, repair or uninstall | Installation |
| Search files, use the clipboard | Launcher |
| Set up keybinds | Keybinds |
| Change the bar or window look | Customizing |
| See what each plugin does | Plugins and features |
| Script it or hand it to an agent | Control |
| Hand an agent one file to read | Agent entry point |
| Check version support | COMPATIBILITY.md |
| Build or contribute | dev/ |
| Rules for coding agents | AGENTS.md |
Omarchy 4.0.0-1 or a nearby build of the same shell generation (live-verified
through 4.0.4-1), Quickshell as provided by Omarchy, and jq. A few optional
tools unlock specific features (video wallpapers, the audio visualizer,
weather); the installer warns about any that are missing. Full list:
Installation.
- Omarchy (github.com/basecamp/omarchy) — the Arch/Hyprland desktop this whole project is built on top of.
omarchy-shell, Omarchy's own Quickshell-based bar/notch/notification runtime, is what every plugin here actually loads into. - Ambxst (by Axenide) — UI/UX design inspiration for several
ruixen.notchpanels (the dashboard layout, calendar, metrics page, wallpapers picker). Ambxst's own code is AGPL-3.0 licensed; ruixen-shell's implementations are written independently, not derived from its source. - xgborgeso/omarchy-peripheral-batteries (MIT) —
ruixen.peripherals's detection logic is ported from this project (see Plugins, and the plugin's own source header for the full attribution).
Released under the MIT License.