macOS-style Exposé for Omarchy: one key or a hot corner shows every open window as a live preview. Type to search, press Space to Quick Look, press Enter to launch.
- Live previews. Cards are real screencopy views, so videos keep playing and terminals keep scrolling. The Omarchy desktop behind the grid stays live too.
- Quick Look. Space enlarges any preview and restores it again. Shift+Space does it in slow motion, like the classic macOS Easter egg.
- Search. Just start typing to filter windows by title or application.
- Workspace scope. Press Tab to switch between every window and windows on the current workspace. Per-monitor mode evaluates the current workspace of the selected display.
- Multi-monitor layouts. The overview opens only on the focused display (or the display whose hot corner was used). Same overview shows every window there; per monitor keeps that display's own windows.
- Built for Omarchy. Runs inside Omarchy Shell, follows the active theme, and adds no packages, services, or daemons.
- Hot corner. Toggle the overview by flinging the pointer into a corner (on by default, any corner, can be disabled).
Everything is tunable from the built-in Settings panel and over IPC, and changes apply instantly.
- Omarchy Quattro with the native shell plugin system
jq
The underlying Quickshell, Hyprland, Bash, and coreutils support ships with Omarchy, so no separate compositor setup is needed.
omarchy plugin add https://github.com/kristofferR/omarchy-expose.git --enableThat's it: the top-left hot corner works right away. Optionally, bind a key in ~/.config/hypr/bindings.lua, then run hyprctl reload:
o.bind("SUPER + A", "Exposé", hl.dsp.event("expose.window-overview:toggle"))Any unused chord works. Avoid modifier-only bindings such as standalone Super; Hyprland cannot reliably distinguish them from the start of normal Super shortcuts.
To keep workspace swipes from changing the desktop behind Exposé, replace your workspace gesture in ~/.config/hypr/input.lua with:
local expose_gesture_path = os.getenv("HOME") .. "/.config/omarchy/plugins/expose.window-overview/workspace-gesture.lua"
local expose_gesture_loader = loadfile(expose_gesture_path)
if expose_gesture_loader then
expose_gesture_loader()({ fingers = 4, scale = 0.5 })
else
hl.gesture({ fingers = 4, direction = "horizontal", scale = 0.5, action = "workspace" })
endAdjust fingers and scale to match your preferred gesture. Only the workspace gesture is swallowed while Exposé is open; media keys and other compositor shortcuts keep working.
omarchy plugin update expose.window-overview --yesDelete the Exposé binding from ~/.config/hypr/bindings.lua, then:
omarchy plugin remove expose.window-overview --yes
hyprctl reloadRemoval leaves nothing behind: Exposé keeps no files outside its plugin directory and its entry in ~/.config/omarchy/shell.json.
| Key | Action |
|---|---|
| Arrow keys | Move selection |
| Any character | Search by title or application |
| Space | Quick Look the hovered or selected preview (enlarge or restore) |
| Shift+Space | Quick Look in slow motion |
| Tab | Toggle all windows or the current workspace |
| Shift+Q | Close the selected window |
| Enter | Activate the selected window |
| Escape | Restore an enlarged preview; press again to close |
Clicking a card activates it; middle-clicking closes it. Activation moves the pointer to the chosen window by default; this is a setting, not a change to Hyprland's global cursor behavior.
The overlay is created on one display only. With Same overview, that display shows every window. With Per monitor, it shows only windows that already belong to that display; after pressing Tab, the current workspace is the one active on that display.
Open Settings from the footer while the overview is open. It is fully keyboard driven: 1-4 jump to a section, Up/Down move between controls, Left/Right adjust sliders and choices, Space or Enter flip toggles and press buttons, Escape closes. Changes apply immediately:
- Opening animation: Original (default), Fade, Zoom, or Slide
- Animation speed saved per mode, linked for in/out by default or expandable to separate timings
- Slide direction: left (default), right, up, or down. Splitting in/out splits both speed and direction
- Background blur (0–20) and dim (0–90)
- Preview placement: in-place or centered
- Window footer style: floating, integrated, overlay, or centered
- Multiple displays: Same overview (all windows together on the selected display) or Per monitor (only that display's windows)
- Bottom text visibility. Hiding it requires confirmation and removes the Settings link
- Hot corner on/off and position (disable the same corner in other hot-corner plugins to avoid overlap)
- Move cursor to the activated window on/off
Every reversible setting is also scriptable:
omarchy-shell expose toggle # also: open, close
omarchy-shell expose settings toggle # also: open, close
omarchy-shell expose animationStyle original # original | fade | zoom | slide
omarchy-shell expose animationDuration original 190 # linked in/out, 100-800 ms
omarchy-shell expose animationDurationIn original 190 # separate opening speed
omarchy-shell expose animationDurationOut original 190 # separate closing speed
omarchy-shell expose slideDirection left # left | right | up | down, both halves
omarchy-shell expose slideDirectionIn left # separate opening side, also splits slide timing
omarchy-shell expose slideDirectionOut right # separate closing side, also splits slide timing
omarchy-shell expose backgroundBlur 4 # 0-20
omarchy-shell expose backgroundDim 6 # 0-90
omarchy-shell expose previewPlacement in-place # in-place | centered
omarchy-shell expose windowFooterStyle floating # floating | integrated | overlay | centered
omarchy-shell expose multiMonitorMode mirrored # mirrored | per-monitor
omarchy-shell expose hotCorner on # on | off
omarchy-shell expose hotCornerPosition top-left # top-left | top-right | bottom-left | bottom-right
omarchy-shell expose moveCursorToWindow on # on | offAfter hiding the bottom text, you can restore it while Settings remains open. If you close Settings first, edit ~/.config/omarchy/shell.json and set "showFooter": true in the expose.window-overview plugin entry.
Exposé runs unsandboxed inside Omarchy Shell with your user's permissions.
- Its helpers are plain Bash calling
hyprctl,jq,sleep, andtimeout. - It reads window, workspace, and monitor state from Quickshell's native Hyprland model, activates or closes the windows you select, and temporarily raises Hyprland's blur while open, restoring the previous value on close.
- Settings writes touch only the plugin's entry in
~/.config/omarchy/shell.json. - No network, no privilege escalation, no package installs, no services.
- No thumbnails: verify Hyprland exposes toplevel-export support and no screen-capture policy blocks Quickshell. Cards stay usable with fallback labels.
- Workspace says “—”: the native Hyprland model has not associated that Wayland toplevel yet. Very short-lived windows can briefly appear this way; restart Omarchy Shell if a normal window remains unassociated.
- Plugin not listed: run
omarchy plugin validate ., thenomarchy-shell shell rescanPlugins. - Shortcut does nothing: run
hyprctl reload, checkhyprctl configerrors, and testhyprctl dispatch 'hl.dsp.event("expose.window-overview:toggle")'directly.
Based on Bird's Eye by Harel Malka.
MIT
