omarchy-scratchpad

A scratchpad occupancy indicator and toggle for the Omarchy shell bar (Quickshell / Hyprland).

Shows an S in the bar when the scratchpad has windows (full opacity); dimmed when empty. Click to toggle the scratchpad open/closed.

Install

omarchy plugin add https://github.com/nlboris/omarchy-scratchpad --enable

Then enable the Scratchpad widget in the bar settings (or add {"id":"rob.scratchpad"} to bar.layout.left in ~/.config/omarchy/shell.json) and restart the shell.

From a checkout

git clone https://github.com/nlboris/omarchy-scratchpad
cd omarchy-scratchpad
omarchy plugin link . --enable
omarchy restart shell

Uninstall

omarchy plugin remove rob.scratchpad
omarchy restart shell

How it works

The widget queries Hyprland for a workspace named special:scratchpad. If it exists and has at least one toplevel window, the indicator lights up. Clicking runs hyprctl dispatch_lua_expression to toggle the special workspace.

Default keybinds (built into Omarchy):

Key	Action
Super + S	Toggle scratchpad
Super + Alt + S	Move window to scratchpad

License

MIT