Repolode
tahayvr

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

Command-line AirDrop for Linux, letting iPhones and Linux machines send files to each other over AWDL on supported non-Apple Wi-Fi cards.

3.3K+86 this week256RustMITWell maintainedUpdated 4 days ago