/ de-omarchy / README.md
swadhinbiswas Initial de-omarchy: Omarchy UI layer for Arch-based distros · 8/22/2026
9f393b2
88 lines · 3.4 KB
Raw Download

de-omarchy

The Omarchy desktop look & workflow for any Arch-based Linux — without
replacing your system.

de-omarchy takes the UI layer of Omarchy
(Hyprland Lua config, Quickshell desktop shell, 22 themes, omarchy CLI,
capture/theming tooling) and installs it on top of an existing setup
(CachyOS, Arch, EndeavourOS, Manjaro…) additively and reversibly:

  • your .zshrc, .zshenv, starship prompt, kitty config and ssh keys are
    never modified — the zsh integration rides a glob your .zshrc already has
    (~/.config/zshrc.d/*.zsh)
  • every keybinding you already have stays bound; Omarchy's bindings are added
    only where they were free (full old-vs-new table:
    keybindings/KEYMAP.md)
  • one marked block is appended to your Hyprland entry file; delete it to revert
  • nothing touches pacman.conf, mirrors, kernels, bootloaders or display manager

Install

git clone <this-repo> ~/de-omarchy
cd ~/de-omarchy
./scripts/diff-preview.sh     # see exactly what would change (dry run)
./install.sh                  # backs up first, then applies

Then either hyprctl reload (instant) or re-login for env vars everywhere.

Uninstall / rollback

./uninstall.sh                # removes block, symlinks, runtime; restores state

Timestamped full backups land in ~/.de-omarchy-backups/<ts>/
(override with DEO_BACKUP_ROOT, e.g. an external drive).

What you get

Piece Detail
Shell Omarchy Quickshell top bar, menu, launcher, notifications, clipboard, emojis
Theming omarchy theme list / omarchy theme set "Tokyo Night" — kitty/btop/gtk/hypr colors follow
CLI the omarchy command router (omarchy --help)
Capture PRINT screenshot, ALT+PRINT recording, OCR extraction
Extras scratchpad, window width memory, nightlight, idle toggles

Default theme after install: rose-pine. Change any time.

Key differences from stock Omarchy

  1. No OS layer: no bootloader, kernel, plymouth, sddm swap, pacman.conf or
    hardware-specific installers run. Your distro stays yours.
  2. No shell takeover: Omarchy is bash-first; de-omarchy keeps your login
    shell and prompt exactly as they are.
  3. Merge-not-replace installer: symlinks + one append block instead of
    copying config trees over ~/.config.
  4. Conflict policy: your existing keys always win (see
    audit/MAPPING.md).

Updating

Pull this repo, re-run ./install.sh — it is idempotent: runtime rsyncs,
symlinks refresh, the hyprland.lua block is appended only if missing.

Layout

audit/        what was found on the source machine & how conflicts were resolved
bin/          omarchy-* commands (vendored from upstream, MIT)
shell/        Quickshell desktop (vendored)
themes/       22 themes + wallpapers (vendored)
default/      hypr lua runtime, templates, fonts (vendored)
config/       user-side hooks: hypr layer, zsh hook, defaults
packages/     curated UI-only package list
display/      real monitor layout captured from the source machine
keybindings/  KEYMAP.md — complete combined map
scripts/      backup / diff-preview / verify / scan-secrets

Credits & license

Omarchy by David Heinemeier Hansson and contributors, MIT — vendored components
retain that license (LICENSE.upstream). Everything de-omarchy adds is MIT too
(LICENSE).