Hyprland: A highly customizable dynamic tiling Wayland compositor.
Waybar: A customizable, modular status bar.
AGS: Aylur's Gtk Shell, used for creating custom, scriptable desktop widgets.
Dynamic Theming: Seamlessly integrated with Pywal to extract color palettes from wallpapers and apply them instantly across the entire system (widgets, terminal, status bar).

Directory Structure

hypr/: Hyprland configurations (keybindings, window rules, animations, monitor layout, lid-close display handling, and autostart). See hypr/keybinds.md for custom keybindings.
waybar/: Status bar layout, CSS styling, and custom interactive modules.
ags/: Custom desktop widgets built with TypeScript and GTK — media player, notification hub, quick settings, system monitor, wallpaper picker, and theme picker.
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.
omarchy/hooks/: Event hooks for the Omarchy system (e.g. automatically applying dynamic themes when changing wallpapers).
branding/: Custom ASCII art and system branding assets.

Docs

Wallpaper Gallery — preview of every wallpaper in wallpapers/, split alphabetically across 0-9, A-E, E-M, M-R, R-Y.
Themes — how to add a local color theme.
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.

# 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