Wallpaper Hub

A wallpaper grid for Omarchy v4 ("Quattro") that is a first-class citizen of the native background system — plus Wallhaven search and one-click download.

• Library grid — every wallpaper from your per-theme user dir (~/.config/omarchy/backgrounds/<theme>/) and the theme-shipped set, with the current one highlighted. Click to set: the change goes through omarchy-theme-bg-set, so you get the native 420 ms reveal transition and persistence (lock screen, omarchy-theme-bg-next cycling, reboot).
• Thumbnails for free — reuses the first-party image-selector cache; nothing is thumbnailed twice.
• Wallhaven — search (or browse the monthly toplist), SFW-only, and download straight into your per-theme dir, where the native switcher and theme rotation adopt it. The chosen wallpaper applies immediately.
• No second daemon — no swww/hyprpaper, no competing background surface; Omarchy's own background plugin keeps rendering.

Install

omarchy plugin add https://github.com/devmobasa/omarchy-wallpaper-hub --enable

Summon it:

omarchy-shell shell toggle community.wallpaper-hub '{}'

Keybinding suggestion for ~/.config/hypr/bindings.lua:

o.bind("SUPER + SHIFT + W", "Wallpaper hub", "omarchy-shell shell toggle community.wallpaper-hub '{}'")

Notes

• Wallpapers set from outside the two native dirs are discarded on the next theme switch by Omarchy itself — that is why downloads land in ~/.config/omarchy/backgrounds/<theme>/ (bound to the current theme).
• Wallhaven allows 45 unauthenticated requests/minute; the hub fetches thumbnails one at a time and only on demand.
• Per-monitor wallpapers are not supported by Omarchy's background renderer, so the hub does not pretend otherwise.

Tests

./test/all   # node model + contract + static QML checks, manifest, qmllint

License

MIT