WindowsPlease

Spatial hotkey hints for Omarchy Quattro (Hyprland + omarchy-shell).

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

What it does

WindowsPlease draws in-window reminders of the tiling shortcuts that already exist on Omarchy, placed where those actions live:

• Close sits at the top-right, like a window caption button
• Grow/shrink sit on the matching edges
• Focus and swap sit along the same sides, still inside the frame

There are two looks, both click-through so the real Super+… binds still work:

Mode	Default key	What you see
badges	Super+H	Omarchy-themed hint chips on the active window
win31	Super+Shift+H	Windows XP Luna chrome, XP tooltips, and the control-menu already open for actions that have no caption button

The overlay stays up for 15 seconds, then fades. Escape fades it immediately. Using a shown hotkey flashes that hint.

Install

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

Then add binds in ~/.config/hypr/bindings.lua (change the keys if you like):

o.bind("SUPER + H", "Window hotkey hints",
  "omarchy-shell windowsplease toggle '{\"mode\":\"badges\"}'")
o.bind("SUPER + SHIFT + H", "Windows XP hotkey overlay",
  "omarchy-shell windowsplease toggle '{\"mode\":\"win31\"}'")

Reload Hyprland (hyprctl reload).

Configure

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

{
  "defaultMode": "badges",
  "duration": 15000,
  "win31": { "showTitle": true }
}

JSON in the keybind payload overrides this file (mode, duration). See windowsplease.json.example.

Remove

omarchy plugin remove jose.windowsplease

Develop

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

Stack: Omarchy shell plugin (Quickshell/QML overlay), hyprctl for window geometry, Node node --test.

License

MIT. See LICENSE.