omarchy-loop 🎡

Loop-style radial window snapping for Omarchy — hold a chord, a ring appears at your cursor, a live preview shows exactly where the window will land, release to snap.

Built for people who prefer macOS-style floating window management over automatic tiling. No daemon, no extra process — it runs as an Omarchy shell plugin inside the Quickshell instance you already have.

What it does

• Hold SUPER+CTRL → radial ring at the cursor with mini layout icons
• Sweep the mouse toward a direction → segment highlights and a translucent live preview shows the exact target region, animating between choices
• Or use the keyboard while holding the chord:
  • H / J / K / L (or arrows) — halves; press again to cycle half → third → two-thirds (great on ultrawides)
  • U / I / N / M — quarter corners
  • RETURN — cycles maximize → almost-max → center ⅔ → center ⅓
  • ESC — cancel
• Release the chord → snap. Windows are floated and placed with exact, bar-aware geometry.
• Theme-reactive: draws with your Omarchy theme's colors.

While the ring is open, a Hyprland submap suspends all other keybindings, so chord+letter combos can't trigger unrelated shortcuts.

Requirements

Omarchy (the Hyprland fork with the Lua hl.* config API) — tested on Omarchy with Hyprland 0.56.

Install

omarchy plugin add https://github.com/maybeabhinav/omarchy-loop --enable

Then add the contents of loop-bindings.lua to your ~/.config/hypr/bindings.lua (trigger chord + the ring submap) and run hyprctl reload.

The trigger is SUPER+CTRL (both press orders). Edit the two o.bind lines in the snippet to use a different chord.

Credits

• Concept: Loop by MrKai77 (macOS) — the ring + live preview interaction this reimplements for Wayland.
• The exclusive-keyboard-grab and fast-release handling adapts patterns from hyprland-alttab by Valentin Brosseau (MIT).

License

MIT