Inspect live window thumbnails grouped by monitor and switch to a window or workspace.
1 other tool for switch workspacesGood to know
README says focused-monitor targeting is verified on one display; multi-monitor validation remains incomplete.
Get it on GitHub
Unclaimed
Are you @Mindful-Stack?Claim this page to keep it up to date
This page was written by 
Are you @Mindful-Stack?Claim this page to keep it up to date
Find, preview and organize windows across workspaces, and hide selected workspaces from screen captures.
What you can do with Omascape
Drag windows between workspaces and rearrange tiled windows at the drop position.
Good to know
Tiled placement needs dwindle; grouped windows are not re-tiled. If dwindle settings cannot be read, the requested split side is not guaranteed.
Find a window by typing part of its class or title and focus a matching result.
1 other tool for find windowGood to know
Digits join an active query; from v0.5.0, `Space` previews rather than entering a query space.
Show the scratchpad, focus its windows and drag windows into it.
Good to know
The row starts hidden on each open; search covers its windows only while shown.
Blank selected workspaces' windows in screen shares, recordings and screenshots.
1 other tool for screen share privacyGood to know
Other workspaces remain visible. Share indicators may lag a few seconds; exotic scaling can leave a reminder-frame hairline in captures.
Close windows and change their floating or fullscreen state from the overview.
Good to know
`Ctrl+W` follows the resolved target; in selection mode it follows selection rather than hover.
Hold Space to enlarge a window preview or a workspace mini-map before switching.
Good to know
Available inside the overview; hold-only, with no pinned preview. Armed workspaces cannot supply live captures.
Select a window or workspace before committing a switch.
Good to know
Requires `activate: "select"`; the default remains `"enter"`.
Show all 12
Change overview settings from a keyboard-controlled panel.
Good to know
Panel is unavailable during search; custom lock colors and workspace counts above 20 need JSON editing. Malformed files are not overwritten.
Open the overview as a full-width panel below the top bar.
Good to know
Set `anchor` to `"bar"`; a missing, hidden or non-top bar falls back to the centered view.
Toggle the workspace overview from a movable bar button.
Good to know
Removing the button normally unloads the overview too; old installations do not gain the button just by updating.
Move or swap a workspace to another monitor from its actions menu.
Good to know
README says dispatchers were checked against Hyprland source, but not on real multi-monitor hardware.
Before you upgrade Omascape
Newest firstWith no screen share running, run `omarchy plugin disable se.mindfulstack.omascape`, then `omarchy plugin enable se.mindfulstack.omascape --section left`; the overview briefly unloads.
Read the evidence
Removing the button normally unloads the overview and reminder frame; armed workspaces stay blanked. `omarchy plugin list` can report `disabled` for a loaded overview without a button.
Read the evidence
Run `omarchy plugin disable se.mindfulstack.omascape` before `omarchy plugin remove se.mindfulstack.omascape` so registration is removed from `shell.json`.
Read the evidence
Show 3 older
Remove `se.mindfulstack.omyview` and install Omascape; rename `omyview.json` and `omyview-locks.json` to `omascape.json` and `omascape-locks.json` in `~/.config/omarchy/`.
Read the evidence
Point the toggle at `se.mindfulstack.omascape`, change layer namespace `omyview` to `omascape`, then run `hyprctl reload` and `omarchy restart shell`.
Read the evidence
Add the toggle binding manually and run `hyprctl reload`; `scripts/add-keybind.sh` was removed from the installed tree although the README still references it.
Omascape release history 2
v0.6.1
with v0.6.0
with v0.6.0
Open the workspace overview from a button on the Omarchy bar.
Details
v0.6.0 adds a movable bar button and corrects pointer coordinates and synthetic key repeats. v0.6.1 renders window titles and other labels as plain text.
Also: Fixes first clicks on offset monitors, input-method key repeats and markup-like window titles.
Update with `omarchy plugin update se.mindfulstack.omascape`; existing installations need disable/enable migration to add the bar button. Requirements remain Omarchy Quattro, Quickshell, Qt 6.9+ and Lua-configured Hyprland.
Added: Toggle the workspace overview from a movable bar bu…Action required: Toggle the workspace overview from a movable bar bu…Behavior changedAction requiredNow works / inferred: Inspect live window thumbnails grouped by monitor a…Now works / inferred: Hold Space to enlarge a window preview or a workspa…Now works / inferred: Close windows and change their floating or fullscre…Now works / inferred: Select a window or workspace before committing a sw…
Seeded by @iluxav with Codex
Find and organize windows from a live workspace overview.
Details
The first five tags cover the workspace overview and the Omyview-to-Omascape migration. By v0.5.2, Tab steps workspaces, arrows step windows, Space previews the target, and Ctrl+, opens settings.
Also: Search, scratchpad access, capture locks, enlarged previews, window actions and in-picker settings; migration from Omyview.
Install with `omarchy plugin add https://github.com/Mindful-Stack/omascape.git --enable`; bind the toggle manually. Requires Omarchy Quattro 4.x+, Quickshell, Qt 6.9+ and Lua-configured Hyprland.
Added: Inspect live window thumbnails grouped by monitor a…Added / inferred: Drag windows between workspaces and rearrange tiled…Added: Find a window by typing part of its class or title…Added: Show the scratchpad, focus its windows and drag win…Added: Blank selected workspaces' windows in screen shares…Added: Close windows and change their floating or fullscre…Added: Move or swap a workspace to another monitor from it…Added / inferred: Hold Space to enlarge a window preview or a workspa…Added: Select a window or workspace before committing a sw…Added: Change overview settings from a keyboard-controlled…Added: Open the overview as a full-width panel below the t…Action requiredAction requiredAction required / inferred
Seeded by @iluxav with Codex
Read the evidence
- Mindful-Stack/omascape/blob/v0.3.0/README.md
- Mindful-Stack/omascape/blob/v0.5.2/README.md
- Mindful-Stack/omascape/blob/v0.5.2/logic.js
- Mindful-Stack/omascape/blob/v0.5.0/Overview.qml
- Mindful-Stack/omascape/blob/v0.5.0/PeekLayer.qml
- Mindful-Stack/omascape/blob/v0.4.0/README.md
- Mindful-Stack/omascape/compare/v0.5.1...v0.5.2