ScratchPeek adds a window list to Omarchy’s scratchpad, usually opened with Super + S. The bar shows how many windows are in it and which monitor it’s open on. From the list, you can switch to a window, move it to another workspace, or add a window to the scratchpad. Individual tabs in Hyprland window groups are listed separately.
Polski · Preview · User guide · Changelog
omarchy plugin add https://github.com/Sarr77/ScratchPeek --enableThe widget appears on the left of the bar. You can move it with Omarchy’s bar editor.
Requires Omarchy Quattro with the Quickshell bar. Moving windows requires Hyprland 0.56+ with Lua configuration. Tested on Omarchy 4.0.4 and Hyprland 0.56.2; no additional runtime packages are needed.
Click the bar indicator to show or hide the scratchpad on that monitor. Right-click it to open the window list and settings.
| In the panel | Action |
|---|---|
| Click a window’s name | Switch to that window or tab |
| Move out | Choose a workspace to move the window to |
| Ctrl + click Move out | Move it to this monitor’s current workspace |
| Add window to scratchpad… | Choose a window to add |
| Ctrl + click Add window… | Add the focused application window |
Moving a tab leaves the other windows in its group where they are. Hiding the scratchpad leaves its windows inside.
The panel has controls for language, colors, presets, scale and labels. Appearance changes preview as you edit them. Apply saves them; Cancel restores the previous settings.
The ? button switches hover hints on or off. They start enabled and hide automatically after 100 displays. You can turn them back on at any time. Settings and the hint count are kept through restarts, updates and reinstalls.
Automatic updates are enabled by default. ScratchPeek checks every 6 hours while running, and on startup if it hasn't checked yet that day. From 0.11.1, an update must be an immutable GitHub release whose exact commit has been verified in the Omarchy marketplace. If a download or verification fails, the installed version stays in place.
You can disable updates using the small switch beside ?; this asks for confirmation. Linked development copies, forks and locally modified code are not updated automatically. See update details.
To update manually, or to get automatic updates when upgrading from 0.10.0:
omarchy plugin update sarr.scratchpeekomarchy plugin remove sarr.scratchpeekRemoving the widget leaves your windows and workspaces as they are. Settings
are kept in ~/.local/state/scratchpeek/preferences.json, or under
$XDG_STATE_HOME/scratchpeek if set. Delete that file after removal if you
also want to reset your preferences.
ScratchPeek reads local window and monitor state, theme information and app
icons. It uses hyprctl to read state and carry out window actions. Window
titles are not saved to disk. It does not change your keybindings.
Automatic updates contact GitHub and the Omarchy marketplace using Python 3 and Git. Update times and results are stored locally alongside preferences. There is no telemetry. The plugin runs inside Omarchy’s shell with your user permissions and does not need administrator access.
If you like ScratchPeek, take a look at WindowPeek. It lets you search, preview and switch to windows across workspaces and monitors, including individual tabs in Hyprland groups. You can also move windows between workspaces or into the scratchpad.
Report a bug · Development · Tests and limitations
MIT · © 2026 Sarr. Adapted Omarchy controls retain their MIT notice.
