A GUI file manager for Linux Wayland desktops on Omarchy, offering list, column, grid and two-pane views with Quick Look previews.
tahayvr/omarchist
A Rust/GPUI desktop app that lets Omarchy Linux users edit themes, Hyprland settings, keybinds and automation flows through a GUI.
- Stars
- 778
- Forks
- 22
- Open issues
- 0
- Last commit
- 20 days ago
What is it?
Omarchist is a graphical companion app for Omarchy Linux, a Hyprland-based setup. It lets you design themes, tune window and input settings, change keybinds, and chain actions together without hand-editing configuration files. It is positioned as an optional add-on rather than a replacement for Omarchy itself.
The theme designer creates a theme from scratch or from an image and writes a colors.toml file, from which Omarchy generates terminal, border, bar and editor themes. The configuration page adjusts gaps, borders, blur, keyboard, mouse and touchpad settings, storing its values in a separate Lua file that is loaded from hyprland.lua.
The keybind editor searches and changes Hyprland bindings, and the flow editor lets you combine steps such as opening apps, changing settings, prompting for input and branching with If. Flows can be triggered from keybinds, the launcher, at startup, from the command line, or by automation events such as a schedule or a charger being unplugged.
Key features
- 01Design Omarchy themes from scratch or from an image, writing colors.toml.
- 02Adjust gaps, borders, blur, keyboard, mouse and touchpad settings live.
- 03Search and change Hyprland keybinds with a recording-style editor.
- 04Build flows that chain app launches, setting changes, prompts and conditionals.
- 05Run flows from keybinds, the launcher, the command line, or automation triggers.
- 06Operate every page and dialog from the keyboard.
Use cases
- Customizing the look of an Omarchy desktop without editing config files.
- Tweaking Hyprland gaps, blur and input behavior through a visual panel.
- Automating repetitive desktop routines, such as opening a set of apps at login.
- Sharing and installing reviewed workflow templates from a community catalog.
Quick start
- 1
Install Omarchist from the AUR with yay
yay -S omarchist-bin
Things to know
- Only works on Omarchy Linux, so it is not usable on other systems.
- Version 2.x targets Omarchy Quattro (v4); Omarchy 3.x requires an Omarchist 1.x release.
In collections
Topics
FAQ
- What is omarchist?
- A Rust/GPUI desktop app that lets Omarchy Linux users edit themes, Hyprland settings, keybinds and automation flows through a GUI. Omarchist is a graphical companion app for Omarchy Linux, a Hyprland-based setup. It lets you design themes, tune window and input settings, change keybinds, and chain actions together without hand-editing configuration files. It is positioned as an optional add-on rather than a replacement for Omarchy itself.
- Is omarchist free to use? What license does it have?
- omarchist is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
- Is omarchist still maintained?
- Actively maintained. The last commit to omarchist was on Oct 17, 2026.
- What can I use omarchist for?
- Customizing the look of an Omarchy desktop without editing config files. Tweaking Hyprland gaps, blur and input behavior through a visual panel. Automating repetitive desktop routines, such as opening a set of apps at login. Sharing and installing reviewed workflow templates from a community catalog.
- How do I install omarchist?
- Install Omarchist from the AUR with yay: yay -S omarchist-bin
- Where can I get omarchist?
- The source code and installation instructions are on GitHub: https://github.com/tahayvr/omarchist
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A Raycast-style launcher for the Omarchy Linux desktop that searches apps and Omarchy actions, learning what you use most.
A tiny animated pixel campfire that lives in the Omarchy Quickshell bar, opening into a popup where you add logs and stoke the fire.
A Rust component library for the GPUI UI framework, with light and dark themes for every component and a live WebAssembly gallery.
A native desktop GUI for FFmpeg that gives granular control over video, audio, image, subtitle and metadata conversion settings.
Command-line AirDrop for Linux, letting iPhones and Linux machines send files to each other over AWDL on supported non-Apple Wi-Fi cards.