Omapaper

Every wallpaper you own, in one picker.

Omarchy ships wallpapers separated by themes and only ever shows you the handful belonging to the theme you are on.

Omapaper opens all of them at once — every theme's wallpapers plus your own — in Omarchy's native picker, labelled by theme and searchable as you type. And if you add new wallpapers to any theme folder, Omapaper auto-loads them.

Install

omarchy plugin add https://github.com/IuriAmauri/Omapaper.git --enable

Remove

omarchy plugin remove omapaper

That disables the widget, drops it from the bar, and deletes the plugin. The staging directory it builds is the one thing left behind:

rm -rf ~/.cache/omarchy/all-backgrounds

Use

Interaction	Action
Left click	Browse every theme's wallpapers
Middle click	Next wallpaper
Right click	Open settings in your editor

Right click opens ~/.config/omarchy/shell.json in your default editor (omarchy default editor), scrolled to nothing in particular — find the omapaper entry in bar.layout and edit keybind or folder there. Changes apply on save.

Filtering

The picker opens with a live filter — just start typing. It matches on the label, so nord narrows to that theme, moon finds a wallpaper by name.

Keyboard shortcut

SUPER + CTRL + ALT + SPACE opens the picker, set up for you on install. To change it, edit Keyboard shortcut in Omapaper's widget settings, or set keybind on the widget's entry in ~/.config/omarchy/shell.json:

{ "id": "omapaper", "keybind": "SUPER + F1" }

Set it to "" to run with no shortcut at all.

Before binding, the plugin checks whether the combination already belongs to something else, and if true, does nothing. The binding is registered by the widget, so it only exists while Omapaper is in your bar.

Extra wallpaper folder

To pull in wallpapers from a folder of your own, set Extra wallpaper folder in Omapaper's widget settings, or set folder on the widget's entry in ~/.config/omarchy/shell.json:

{ "id": "omapaper", "folder": "~/Pictures/Wallpapers" }

Images directly in that folder are labelled with the folder's name. Subfolders are not searched.

How it works

scripts/wallpapers stages every theme's backgrounds as symlinks named <theme> <name> under ~/.cache/omarchy/all-backgrounds, then points the stock Omarchy image picker at that one directory. Your extra folder, if set, is read straight from shell.json so the keyboard shortcut sees it too.

Uses Symlinks rather than hardlinks for compatibility.

Requirements

Omarchy Quattro (plugin manifest schemaVersion: 1).

License

MIT