OPINIONATED OMARCHY
TROUBLESHOOTING CORPUS
790
RECORDS
790
AUDITED
0
UNCHECKED
2388
SOURCES
LIVE
omarchy-theming low occasional DISPUTE

Fix the background switcher not opening with hundreds of wallpapers

omarchywallpaperquickshell
CORRECTED An auditor found the fix wrong or incomplete and rewrote it. · checked against Omarchy omarchy 4.0.4-1 on 2026-10-05
AUDIT NOTE

Checked on this 4.0.4-1 workstation: omarchy-theme-bg-switcher calls omarchy-menu-images without --lazy-thumbnails while omarchy-theme-switcher passes it (line 117), ImagePicker.qml line 437 is a Repeater with a MultiEffect layer per delegate (line 495), and omarchy-shell sets ipc_timeout=${OMARCHY_SHELL_IPC_TIMEOUT:-2s} on line 57 (the record said 58, which is the line that uses it). The default binding is in utilities.lua line 17, hl.unbind plus o.bind is the pattern ~/.config/hypr/bindings.lua documents, and o.bind wraps a string in hl.dsp.exec_cmd. Issue #12792 supports the workaround: the reporter states the carousel appears with OMARCHY_SHELL_IPC_TIMEOUT=15s. What the record missed: an omarchybot comment on #12792 says PR #14117, which bounds picker delegates and image decode work, merged into quattro on 2026-10-03 (confirmed via the PR API). The latest release is still v4.0.4, so it is not shipped yet. The issue stays open for a separate failure: the full row list is sent as one IPC argument and can exceed the argument size limit. Added both to the cause and the fix. The rebinding itself was not exercised.

The cause above was rewritten on 2026-10-05 to match this note; the fix was corrected by the audit itself.

Symptom

Super+Ctrl+Space does nothing since I added a big wallpaper collection (a plugin put about 500 images in ~/.config/omarchy/backgrounds/<theme>/). Running omarchy-theme-bg-switcher in a terminal prints:


omarchy-shell is not responding
Image selector failed to accept request

With only a few images it opens instantly.

Cause

omarchy-theme-bg-switcher calls omarchy-menu-images without --lazy-thumbnails, while the theme switcher passes it. So every thumbnail is prepared up front. The picker (shell/plugins/image-picker/ImagePicker.qml, line 437 on 4.0.4-1) builds one delegate per image with a Repeater, each with masks and a MultiEffect layer, all at once on the shell's main thread. The open IPC answer is sent only after that finishes. /usr/share/omarchy/bin/omarchy-shell waits ${OMARCHY_SHELL_IPC_TIMEOUT:-2s} (line 57 on 4.0.4-1) and then reports the shell as not responding. Upstream PR #14117, merged to quattro on 2026-10-03 and not in v4.0.4, bounds the picker's delegates and decode work. Issue #12792 stays open for a separate limit: omarchy-menu-images still passes the whole row list as one IPC argument, so a large enough collection can exceed the operating system's argument size limit.

Fix

Raise the IPC timeout for the call. The reporter confirmed the carousel then opens after a few seconds:


bg=$(OMARCHY_SHELL_IPC_TIMEOUT=15s omarchy-theme-bg-switcher) && [[ -n $bg ]] && omarchy theme bg set "$bg"

To make the key do the same, rebind it in ~/.config/hypr/bindings.lua. The default is o.bind("SUPER + CTRL + SPACE", "Background switcher", "omarchy-menu toggle background") in /usr/share/omarchy/default/hypr/bindings/utilities.lua:


hl.unbind("SUPER + CTRL + SPACE")
o.bind("SUPER + CTRL + SPACE", "Background switcher",
  [[bash -c 'bg=$(OMARCHY_SHELL_IPC_TIMEOUT=15s omarchy-theme-bg-switcher) && [ -n "$bg" ] && omarchy-theme-bg-set "$bg"']])

The rebinding was not tested. If the key does nothing, run the terminal form above. The other workaround is fewer images per folder: move part of the collection somewhere the switcher does not read.

The upstream fix, PR #14117, is merged to quattro but not in v4.0.4. Once omarchy update brings a release that contains it, delete the two lines above so the default binding returns. A very large collection can still fail after that release with an argument size error, which #12792 tracks separately. Fewer images per folder is the workaround for that case.

Verify

Run the terminal form. The carousel appears instead of omarchy-shell is not responding.

Sources

background-switcher-times-out-many-wallpapers