FocusPlease

Give the focused window its configured pixel size on Omarchy Quattro (Hyprland + omarchy-shell). Nested splits borrow space from other columns so a window in a split row can still claim its size. When the workspace is too full for usable windows, a dialog offers to move some to the next workspace.

Supporting Omarchy from El Salvador, Central America! I hope this plugin is useful for everyone. Greetings, Jose.

What it does

Each tiled window remembers the size it had when you last resized it (pixels, not a percentage of the screen). On focus it claims that size only if you resized it. If you never resized the focused window, the plugin does not relayout. Unfocused windows then cede leftover in proportion to their current size, not a remembered one.

Columns, stacked windows, and nested splits are handled together: if the focused window sits in a split inside a column, that column grows by taking space from the other columns so siblings are not the only ones that shrink.

Examples on a 1920px-wide row:

• A configured 1000px, B unconfigured → focus A: A=1000, B=920. Focus B (also 1000px): they swap.
• B configured 1200px → focus B: B=1200, A=720.
• Three unconfigured windows → 640px each. Give A 1000px → B and C split the remaining 920px (460 each).

Behavior	How
Claim configured size	automatic, on focus
Set a window's focused size	resize it with Omarchy's normal resize keys
Forget a window's size	omarchy-shell focusplease resetBase
Too many windows	dialog to move selected windows to the next workspace
Toggle	Super + Z

While enabled, focus-follows-mouse is off (click or keyboard only), so hovering does not trigger a relayout. Disabling the plugin restores Hyprland's previous follow_mouse setting.

Usable size is derived from the monitor work area (resolution, scale, reserved bar). If tiled windows on the current workspace cannot all keep that minimum, the plugin asks which ones to send to the next workspace (follow = false, you stay put). Space toggles a row, Enter moves, Escape cancels.

Install

omarchy plugin add https://github.com/VisorDTE/FocusPlease.git --enable

Then add a bind in ~/.config/hypr/bindings.lua:

o.bind("SUPER + Z", "Toggle focus magnify",
  "omarchy-shell focusplease toggle")

Reload Hyprland (hyprctl reload).

Configure

Optional file: ~/.config/omarchy/focusplease.json (hot-reloads on save):

{
  "enabled": true,
  "includeFloating": false,
  "overcrowd": {
    "enabled": true,
    "minWidthRatio": 0.18,
    "minHeightRatio": 0.22
  }
}

Per-window focused sizes live in ~/.local/state/omarchy/focusplease/bases.json (written when you resize a focused window). Opening sizes live in ~/.local/state/omarchy/focusplease/births.json (recorded when a second tiled window appears, never the fullscreen size of a solo window). resetBase drops the resized size so the window claims its Hyprland birth size again.

Commands

omarchy-shell focusplease toggle
omarchy-shell focusplease enable
omarchy-shell focusplease disable
omarchy-shell focusplease status
omarchy-shell focusplease resetBase
omarchy-shell focusplease reset
omarchy-shell focusplease suggest

Remove

omarchy plugin remove jose.focusplease

Develop

cd ~/source/FocusPlease
npm test
omarchy plugin validate .

Requires Omarchy Quattro 4.0.1+ (Hyprland 0.56 Lua dispatchers). Stack: Omarchy shell service + overlay plugin (Quickshell), hyprctl, Node node --test.

License

MIT. See LICENSE.