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

Fix a blank wallpaper and dangling background symlink after applying a custom theme

omarchyomarchy-4hyprlandwayland
AUDITED Audited against its sources and confirmed accurate.

Symptom

After applying a user-installed theme the notification says "No background was found for theme", and later, after a shell restart or reboot, the desktop has no wallpaper at all. omarchy theme bg current prints Unknown.

Cause

set_theme_background (bin/omarchy-theme-set:94-100) notifies and returns without touching ~/.local/state/omarchy/current/background when the new theme ships no backgrounds/ directory. But the previous wallpaper lived at current/theme/backgrounds/<file>, and bin/omarchy-theme-set:164 has just rm -rf'd and replaced that directory. So the symlink now points into a directory that no longer exists. All 22 shipped themes have backgrounds, so this only bites user-installed themes.

Fix

Confirm the dangling link:


readlink ~/.local/state/omarchy/current/background
readlink -f ~/.local/state/omarchy/current/background   # resolves to nothing
[[ -e ~/.local/state/omarchy/current/background ]] && echo ok || echo DANGLING

Give the theme a background so this stops happening:


mkdir -p ~/.config/omarchy/themes/<my-theme>/backgrounds
cp ~/Pictures/wall.jpg ~/.config/omarchy/themes/<my-theme>/backgrounds/1-wall.jpg
omarchy theme set <my-theme>

Or point the background at any image directly without touching the theme:


omarchy theme bg set ~/Pictures/wall.jpg

Verify

readlink -f ~/.local/state/omarchy/current/background resolves to a file that exists, and omarchy theme bg current prints its name instead of Unknown. The wallpaper survives omarchy restart shell.

Sources

theme-without-backgrounds-blanks-wallpaper