Hyprland

Hyprland Lua config layered on Omarchy — bindings ported from niri, master layout, terminal-only blur, monitors, and the omarchy-* helper scripts.

Hyprland is a dynamic tiling Wayland compositor. This config uses Hyprland’s Lua configuration and sits on top of Omarchy, which provides the defaults, theme, menus, and omarchy-* commands. The files here only override. Most bindings are ported from the niri config so the same keys do the same jobs.

Files

None are templates. Hyprland and Omarchy are not in .chezmoidata/packages.yaml. They come from the Omarchy install.

Entry point

hyprland.lua loads Omarchy, then the personal files, then Omarchy’s toggles:

dofile((os.getenv("OMARCHY_PATH") or "/usr/share/omarchy") .. "/default/hypr/bootstrap.lua")
require("default.hypr.omarchy")

require("hypr.monitors")
require("hypr.input")
require("hypr.bindings")
require("hypr.looknfeel")
require("hypr.autostart")

require("default.hypr.toggles")

Omarchy’s default bindings stay enabled. omarchy_default_bindings and omarchy_preinstalled_bindings are left commented. bindings.lua unbinds each default it replaces.

Workspace rules

Window rules

Scratch residents are placed silent so that omarchy-toggle-scratch decides when to reveal them. The YouTube rule matches both youtube.com and www.youtube.com because Chromium’s class changes once a video plays. It excludes the picture-in-picture overlay so Omarchy’s own PiP rule still applies. Its size and inset must stay in sync with omarchy-pip.

Input

input.lua:

• repeat_delay = 250 (Omarchy’s value), repeat_rate = 50 (raised from 40). The file’s comments record that 200/50 felt too fast. The typing lag it was meant to fix came from the keyboard’s firmware tap-hold handling and was fixed on the keyboard itself.
• Tablet and touch devices are pinned to one output each:

The layout, touchpad, and gesture examples in the file are commented out. Palm rejection is done by a libinput quirks file in /etc, which chezmoi does not manage.

Look and feel

looknfeel.lua loads after the Omarchy theme’s hyprland.lua, so its values override the theme’s. The theme sets colors. This file sets everything else. The approach is flat windows by default, with blur only behind terminals.

Blur must be enabled globally before any window can use it, so every window tagged default-opacity gets no_blur = true, and terminals get it back:

o.window({ tag = "default-opacity" }, { no_blur = true })
o.window(
  "^(kitty(-.*)?|Alacritty|com\\.mitchellh\\.ghostty|foot|org\\.codeberg\\.dnkl\\.foot|wezterm)$",
  { no_blur = false }
)

Omarchy’s stock fade (0.985 active / 0.96 inactive) is kept. Terminals get their transparency from kitty’s background_opacity 0.9 (see kitty). The comments give the reason for limiting blur: the cyberdream and Spectra themes enabled rounding, blur, and shadow on every window, and that costs frame time on an iGPU driving the laptop panel plus a 5K display.

Monitors

monitors.lua:

GDK_SCALE=2 is exported. The Studio Display sits left of the laptop panel. At scale 2 its logical width is 2560, so eDP-1 starts at x = 2560.

hyprsunset and portal

profile {
    time = 07:00
    identity = true
}

The identity profile stops hyprsunset from tinting the screen. A commented 20:00 / 4000 K night profile and an o.launch_on_start("hyprsunset") hint remain in the file.

screencopy {
    allow_token_by_default = true
    custom_picker_binary = hyprland-preview-share-picker
}

Screen-share requests get a restore token by default and use hyprland-preview-share-picker as the source picker.

.luarc.json

Configures lua-language-server for the Lua config: the library path is /usr/share/hypr/stubs, checkThirdParty is off, and hl and o are declared as globals.

autostart.lua contains only a commented o.launch_on_start example.

Keybindings

Every binding defined in bindings.lua. Bindings not listed here are Omarchy defaults. The Replaces column gives the Omarchy default that was unbound first.

Windows

SUPER + TAB walks a ring built only from the active workspace’s mapped windows, ordered by stable_id. Grouped windows stay in the ring and hidden ones are skipped. It raises the focused window afterwards. It avoids cyclenext, which would pull in a hidden scratchpad. binds.movefocus_cycles_groupfirst = true makes hjkl focus step through a group’s tabs before leaving the group.

Workspaces and monitors

Named workspaces replace niri-dynamic-workspaces. SUPER + ALT + S (send to scratchpad) keeps its Omarchy default.

Sizing

Applications

The two flea bindings and a rule tagging com.thisisgm.flea.picker as +floating-window sit between flea --default / flea --picker marker comments. The flea tool writes and removes those blocks itself.

Screenshots, session, menus

SUPER + SPACE (Omarchy menu), SUPER + ALT + SPACE (apps menu), and SUPER + SHIFT + RETURN (browser) keep their Omarchy defaults.

ScrollOverview plugin

When hl.plugin.scrolloverview is present, bindings.lua configures it:

omarchy scripts

The scripts live in dot_local/bin/ as executable_omarchy-* and deploy to ~/.local/bin/. Each one calls the Lua dispatcher first (hyprctl dispatch "hl.dsp…") and falls back to the classic dispatcher name on older Hyprland.

omarchy-cycle

omarchy-cycle <app|browser|brave|terminal|ai|ghostty|kitty|kitty-CLASS|webapp|webapp-NAME>

Focuses an app’s window, cycles to the next one on repeated presses, or launches the app when none is open. Windows are matched on class or initialClass (case-insensitive) and sorted by workspace, then address. If the focused window is not in the set, focus goes to the first one. Launches use setsid uwsm-app --.

Bound to SUPER + CTRL + ALT + H (ai), G (ghostty), and O (obsidian).

omarchy-cycle-browser / omarchy-cycle-terminal

One-line wrappers: omarchy-cycle brave and omarchy-cycle terminal. Bound to SUPER + CTRL + ALT + K and SUPER + CTRL + ALT + J.

omarchy-cycle-window-size

omarchy-cycle-window-size [next|prev]

Steps the focused window through preset widths 0.333, 0.5, 0.667 of the monitor.

• Scrolling layout (tiled): sends colresize +conf / -conf, so the layout’s own preset list is used.
• Floating: resizes to the fraction × monitor width and 0.8 × monitor height, then centers. The index is stored per window.
• Dwindle/master (tiled): sets splitratio to 2 × fraction, mirrored when the window is on the right or bottom half, clamped to 0.1–1.9. The index is stored per workspace.

Indices are stored in $XDG_STATE_HOME/omarchy/window-sizes/. Bound to SUPER + R and SUPER + SHIFT + R.

omarchy-pip

omarchy-pip [toggle|on] [address:0x...]

Picture-in-picture for any window. Floats and pins it, resizes it to 30% of the focused monitor on both axes, and places it in the bottom-left corner with a 10 px inset (matching general:gaps_out). toggle (the default) unpins and re-tiles a window that is already floating and pinned. on always applies the fit. Defaults to the active window. The dispatcher is called with on/off because set toggles on Hyprland 0.56. Bound to SUPER + SHIFT + T. omarchy-summon also calls it.

omarchy-smart-move

omarchy-smart-move <l|r|u|d>

• Tiled: finds the nearest tiled, visible window in that direction that overlaps on the other axis. If that neighbor, or the focused window, is in a group, it runs a group-aware move (movewindoworgroup), which merges into or leaves a group. Otherwise it swaps with the neighbor.
• Floating: moves the window to a corner of its monitor without resizing, inside the reserved area (the bar) and inset 10 px. Corners go clockwise from bottom-left: l bottom-left, d top-left, u top-right, r bottom-right.

Bound to SUPER + SHIFT + H/J/K/L.

omarchy-summon

omarchy-summon [youtube]

The only profile is youtube, which matches class ^brave-(www\.)?youtube\.com__.*$ and skips Picture-in-Picture titles. With no window open, it runs gtk-launch YouTube, and the window rule in hyprland.lua floats and positions it. With a window open, it moves the window to the focused monitor, runs omarchy-pip on to refit it (the two panels differ in logical size), and focuses it. Bound to SUPER + CTRL + ALT + Y and SUPER + SHIFT + Y.

omarchy-toggle-layout

omarchy-toggle-layout [width]

Runs omarchy-hyprland-workspace-layout-toggle, then polls the workspace layout (6 × 50 ms). If it became scrolling, it runs colresize all <width> (default 0.75). Dwindle needs no widths. Bound to SUPER + W.

omarchy-toggle-scratch

omarchy-toggle-scratch [scratchpad|fastmail|beeper]

If the workspace is visible, the script hides it. If not, it launches any resident with no window there, waits up to 8 s for the first new window, and reveals the workspace on the home monitor (or the focused one if the home monitor is absent). Launching only missing residents avoids duplicate web-app windows. Bound to SUPER + CTRL + S, SUPER + A, SUPER + CTRL + ALT + E, and SUPER + CTRL + ALT + M.

Related

• niri: the original config these bindings mirror.
• Waybar: the bar used with this setup.
• kitty: the herdr and goliath kitty configs launched here.