crueber/omarchy-hermes-desktop-overlay
Watch
1
0
Fork
You've already forked omarchy-hermes-desktop-overlay
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Omarchy plugin: hotkey pulls Hermes Desktop down over 3/4 of the screen as a Quake-style HUD overlay
2 commits 1 branch 0 tags 9.7 KiB
  • Shell 90.6%
  • QML 9.4%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
crueber 4d782ce29a Point homepage and install docs at the GitHub mirror
2026-08-25 17:29:01 -05:00
scripts Initial release: Quake-style pull-down HUD for Hermes Desktop 2026-08-25 17:21:21 -05:00
install.sh Point homepage and install docs at the GitHub mirror 2026-08-25 17:29:01 -05:00
LICENSE Initial release: Quake-style pull-down HUD for Hermes Desktop 2026-08-25 17:21:21 -05:00
manifest.json Point homepage and install docs at the GitHub mirror 2026-08-25 17:29:01 -05:00
README.md Point homepage and install docs at the GitHub mirror 2026-08-25 17:29:01 -05:00
Service.qml Initial release: Quake-style pull-down HUD for Hermes Desktop 2026-08-25 17:21:21 -05:00
uninstall.sh Initial release: Quake-style pull-down HUD for Hermes Desktop 2026-08-25 17:21:21 -05:00

README.md

omarchy-hermes-desktop-overlay

Quake-style pull-down HUD for Hermes Desktop on Omarchy. A hotkey drops a floating Hermes window over 3/4 of your screen, dimming what's behind it; press the hotkey again and it slides back up. If Hermes isn't running yet, the first press launches it.

It works at the Hyprland level: the app lives in its own special workspace (special:hermes) that overlays whatever you're working on, with Omarchy's built-in slide animation. No QML UI — the plugin's shell entry point is a deliberate no-op.

Requirements

  • Omarchy (Hyprland 0.55+ with Lua config)
  • Hermes Desktop installed at /usr/bin/hermes-desktop (omarchy install / pacman -S hermes-agent-desktop)

Install

omarchy plugin add https://github.com/crueber/omarchy-hermes-desktop-overlay
~/.config/omarchy/plugins/crueber.hermes-overlay/install.sh

The default hotkey is SUPER + SHIFT + H. To pick a different key (or a different launch command):

./install.sh --key "SUPER + GRAVE" --launch "/usr/bin/hermes-desktop"

install.sh writes clearly marked, idempotent blocks into ~/.config/hypr/hyprland.lua (window rule) and ~/.config/hypr/bindings.lua (keybinding), then reloads Hyprland and validates the config.

Usage

Key Action
SUPER + SHIFT + H Toggle the Hermes HUD open/closed

Uninstall

~/.config/omarchy/plugins/crueber.hermes-overlay/uninstall.sh
omarchy plugin remove crueber.hermes-overlay

Customization

Edit the managed block in ~/.config/hypr/hyprland.lua, or reinstall with different options:

  • Window size: change the 0.75 fractions in the rule's size.
  • Transparency: change opacity = "0.96" (or remove it).
  • Backdrop dimming: remove dim_around = true.
  • Different app: HERMES_OVERLAY_CLASS, HERMES_OVERLAY_WORKSPACE, and HERMES_OVERLAY_LAUNCH env vars override the toggle script's defaults, so the same pattern works for any single-window app.

How it works

  1. A window rule matches the Hermes window class (hermes) and forces it floating, centered, sized to 75% of the monitor, opened silently into the special:hermes workspace.
  2. The keybinding runs scripts/hermes-overlay-toggle, which launches Hermes if needed and dispatches hl.dsp.workspace.toggle_special('hermes').
  3. Special workspaces render over the active workspace and inherit Omarchy's vertical slide animation, producing the drop-down HUD effect.

License

MIT