Hyprland is the soul of Omarchy. Forget dragging windows — you tile. Here’s how to think, move, and customize like an Omarch.

The mental model

• Windows tile automatically, no overlap.
• You organize with workspaces (1–10), not minimizing.
• Super (⌘/Win) is your conductor.

DHH’s essential keybindings

These are mapped via Omarchy’s Lua helpers (o.bind):

-- ~/.config/hypr/hypr.bindings
o.bind("SUPER + RETURN", "Terminal", { focus="Alacritty", launch="alacritty" })
o.bind("SUPER + SPACE", "Launcher")

Pro move: Hold Super and scroll to resize. Hold Super + Shift and drag to move floating windows.

The three-layer config (Lua)

Omarchy’s Hyprland config is Lua, not hyprland.conf:

~/.config/hypr/hyprland.lua          ← entry point
~/.config/hypr/hypr.monitors         ← your monitors
~/.config/hypr/hypr.input            ← keyboard / mouse
~/.config/hypr/hypr.bindings         ← your overrides
~/.config/hypr/hypr.looknfeel        ← gaps, rounding, blur
~/.config/hypr/hypr.autostart        ← startup apps

Layer 1 = Omarchy defaults (read-only)
Layer 2 = Theme (omarchy.current.theme.hyprland)
Layer 3 = Your overrides (wins)

Because user files are require_optional, theme switching never wipes your tweaks.

Example: bigger gaps for ultrawide

-- hypr.looknfeel
return {
  general = { gaps_in = 8, gaps_out = 16, border_size = 2 },
  decoration = { rounding = 12, blur = { enabled = true, size = 8 } },
}

Then reload: Super + Shift + R or hyprctl reload.

Workspace philosophy

DHH’s workflow: dedicate workspaces, not monitors.

• 1 → browser
• 2 → Neovim / code
• 3 → terminal tumble
• 4 → notes (Obsidian)
• 5 → communication (Slack/Discord web apps)
• 0 → music (Audacious/Spotify PWA)

Move windows with Super + Shift + 1..0 faster than dragging.

Pro tips

1. Wayland env — Omarchy forces GDK_BACKEND=wayland, QT_QPA_PLATFORM=wayland so Chrome/Electron don’t run XWayland blurry.
2. Monitor scaling — Hyprland uses monitor=,preferred,auto,1.25 + GDK_SCALE dual-scale for crisp fonts.
3. Clipboard — Super + V history is unified (wayland + neovim). See Unified Clipboard.
4. Screenshots — omarchy capture screenshot (region/window) → auto-copied.
5. Idle — hypridle dims then locks. Edit ~/.config/hypr/hypridle.conf.

Minimal custom binding to try now

-- hypr.bindings: quick file manager
o.bind("SUPER + E", "Files", { launch = "nautilus" })

Save, reload, press Super+E. That’s the Omarchy way: small Lua, big effect.

Next: Theming Omarchy — Tokyo Night to Catppuccin.