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

Fix black/fuchsia checkerboard placeholders instead of icons on Vantablack/White themes

omarchyomarchy-4hyprlandwayland
CORRECTED An auditor found the fix wrong or incomplete and rewrote it.
AUDIT NOTE

The bug is real and confirmed verbatim: themes/vantablack/icons.theme contains exactly Yaru-gray, and bin/omarchy-theme-set-gnome does if [[ -f $GNOME_ICONS_THEME ]]; then gsettings set ... "$(<$GNOME_ICONS_THEME)"; else ... "Yaru-blue"; fi. The fallback fires only on a MISSING file and never validates the name, exactly as stated. But the prescribed replacements are wrong: Yaru ships color variants (Yaru, Yaru-blue, Yaru-purple, ...), not Yaru-dark/Yaru-light, so the fix swaps one non-existent name for another. Also themes/white/icons.theme is Yaru-grey (different spelling), and yaru-icon-theme is already in install/omarchy-base.packages so the install step is redundant, and pacman -S there should be -Syu.

The cause above was not rewritten and may still contain the error described. The fix below is the corrected version.
RISK

Yaru-dark restores working icons but brings back app brand colors, losing the intentional monochrome look of Vantablack/White. It is a reliability fix, not a design fix.

Symptom

On the Vantablack or White theme, notification icons and some tray/app icons render as a black-and-fuchsia checkerboard placeholder instead of a real icon. The shell log shows WARN: Could not load icon "battery-caution" at size QSize(40, 40) from request, or the same for names like nordvpn-tray-blue.

Cause

vantablack/icons.theme sets the GNOME icon theme to Yaru-gray, but no such icon theme exists on disk. Ubuntu dropped it upstream and neither yaru-icon-theme nor omarchy ships it. The fallback in omarchy-theme-set-gnome only fires when the icons.theme state file is *missing*. It never validates the name it finds. So gsettings ends up pointing at an unresolvable theme and every themed icon lookup fails.

Fix

Confirm the bad value and see what icon themes actually exist:


gsettings get org.gnome.desktop.interface icon-theme   # -> 'Yaru-gray'
ls /usr/share/icons                                     # the real list

Both affected themes name a Yaru grey variant that does not exist, with different spellings:


themes/vantablack/icons.theme -> Yaru-gray
themes/white/icons.theme      -> Yaru-grey

Yaru-dark and Yaru-light do not exist either. Yaru ships colour variants. Use a name that is really installed. Omarchy's own built-in fallback is Yaru-blue, so it is the safe choice:


cp -a "$(omarchy theme dir vantablack)" ~/.config/omarchy/themes/vantablack
echo "Yaru-blue" > ~/.config/omarchy/themes/vantablack/icons.theme
omarchy theme refresh

Same for the White theme:


cp -a "$(omarchy theme dir white)" ~/.config/omarchy/themes/white
echo "Yaru-blue" > ~/.config/omarchy/themes/white/icons.theme
omarchy theme refresh

Verify the name you chose resolves before trusting it:


ls -d /usr/share/icons/Yaru-blue

yaru-icon-theme is already listed in install/omarchy-base.packages, so it should be present. Verify rather than reinstall, and use -Syu (never -S against a stale db, and never -Sy, which causes a partial upgrade):


pacman -Qi yaru-icon-theme >/dev/null 2>&1 || sudo pacman -Syu yaru-icon-theme

Verify

gsettings get org.gnome.desktop.interface icon-theme returns 'Yaru-dark', and omarchy-notification-send -u critical "test" "test" -i battery-caution shows a real battery icon rather than a checkerboard. journalctl --user -b | grep 'Could not load icon' produces no new lines.

Sources

vantablack-white-theme-broken-icon-placeholders