Hyprland: A highly customizable dynamic tiling Wayland compositor.
Omarchy shell: The Quickshell-based bar, notifications, and lock screen that ships with Omarchy 4, configured through omarchy/shell.json.
AGS: Aylur's Gtk Shell, used for creating custom, scriptable desktop widgets — quick settings with a browsable calendar, notification center, system monitor, wallpaper and theme pickers, and a Claude Code usage card fed by Omarchy's own agent usage records.
Dynamic Theming: Seamlessly integrated with Pywal to extract color palettes from wallpapers and apply them instantly across the entire system (widgets, terminal, status bar).
kitty: The terminal, with its own checked-in color theme — see kitty/.

Directory Structure

hypr/: Hyprland configurations (keybindings, window rules, animations, monitor layout, lid-close display handling, and autostart). See hypr/keybinds.md for custom keybindings.
omarchy/: Omarchy 4 configuration — shell.json (bar layout, custom bar modules, and idle/lock timings), extensions/ (entries added to the Omarchy menu), hooks/ (event hooks such as retinting AGS on theme change), plugins/ (forked shell plugins: the bar itself, the menu, and the workspace switcher), and themed/ (extra theme templates). See omarchy/README.md for the bar layout and the plugin clones.
ags/: Custom desktop widgets built with TypeScript and GTK — media player, notification hub, quick settings, system monitor, wallpaper picker, theme picker, and Claude Code usage.
scripts/: Global utility scripts seamlessly exposed as commands by the installer. See commands.md.
wallpapers/: A collection of local custom wallpapers for dynamic theming. See wallpaper-gallery/ for the full gallery (split alphabetically across multiple pages).
themes/: Drop-in local color themes (one colors.toml per theme) that install.sh deploys into Omarchy's theme directory. See themes/README.md.
branding/: Custom ASCII art and system branding assets. blob_icon.svg is the bar menu button.
kitty/: kitty terminal config and its color theme, applied by hand rather than by install.sh. See kitty/README.md.

Docs

Wallpaper Gallery — preview of every wallpaper in wallpapers/, split alphabetically across 0-9, A-E, E-M, M-R, R-Y.
Omarchy shell — bar layout, custom bar modules, and the cloned shell plugins.
Themes — how to add a local color theme.
kitty — terminal config, and how to port a theme to it.
Keybinds — custom Hyprland keybindings on top of Omarchy's defaults.
Commands — custom blob_* CLI commands exposed by the installer.

Installation

An automated installer script (install.sh) is provided to safely apply these configurations to your system. It targets Arch running Omarchy 4 — kitty/ is applied by hand, see kitty/README.md.

# Run the standard installer
./install.sh

# See what would change without modifying any files (dry run)
./install.sh --check

# Force overwrite of any existing local changes
./install.sh --force

The installer also configures the laptop lid switch so the machine stays awake (and the external monitors stay active) when docked or on AC power.

To roll back to the backups the installer created, use revert.sh:

# Restore configs from their .bak versions (prompts first)
./revert.sh