Minimizer Tray

A small bar widget for Omarchy v4 that appears when Hyprland windows are stashed on special:minimized. It shows the number of minimized windows and opens your restore picker when clicked.

The widget is reactive: it reads Hyprland's toplevel list and refreshes from compositor events instead of polling.

Requirements

• Omarchy v4 with the schema-version-1 plugin host
• A minimize-to-tray workflow that moves windows to special:minimized
• An executable restore picker

The default picker path is ~/.config/apps/hyprland-minimizer/restore-preview.sh. Override it with an absolute path when your script lives elsewhere:

omarchy bar set community.minimizer-tray previewScript /absolute/path/to/restore-preview.sh

Install

omarchy plugin add https://github.com/devmobasa/omarchy-minimizer-tray --enable

The widget uses the right section by default and takes no bar space while no windows are minimized.

Scripting

omarchy-shell community.minimizer-tray status

The status call returns the current minimized-window count as JSON.

Tests

./test/all

The suite runs model and contract tests, validates the manifest, and checks the QML against the active Omarchy shell API.

License

MIT