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

Make dark tray icons readable on dark Omarchy themes

omarchythemingiconstray
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

Surveyed /usr/share/omarchy/themes on 4.0.4-1: 17 themes have mode = "dark". solitude names Yaru-sage-dark, vantablack names Yaru-gray, which does not exist, and the other 15 name a light Yaru variant whose -dark sibling exists in yaru-icon-theme. So the cause's '16 of the 17 name a light Yaru variant' miscounts vantablack. The symptom calls nm-applet 'the usual one', but network-manager-applet is not installed on a stock 4.0.4-1 (pacman -Q fails, no nm-applet in /etc/xdg/autostart), so the bug only shows for tray apps a user added. Frequency lowered to occasional. Tray.qml tints only names ending in -symbolic (confirmed, matches #8845). omarchy-theme-set-gnome sets icon-theme from current/theme/icons.theme and QT_QPA_PLATFORMTHEME=gtk3 makes the shell follow it. The overlay works: omarchy-theme-set copies the stock theme (line 269) and then a non-git user dir of the same name over it (line 275). PR #8900 that would switch every dark theme to -dark was closed unmerged. Fix kept, with a note that apps shipping their own tray icon (Steam's steam_tray_mono from its own directory) are not affected by the icon theme.

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

Symptom

On Nord, Tokyo Night, Catppuccin, Gruvbox or most other dark themes, some tray icons are almost invisible when I expand the bar's tray: a dark icon on a dark bar. It shows with tray apps I installed myself, such as nm-applet. Double-clicking the bar to make it transparent over a light wallpaper makes the same icon readable.

Cause

Each theme names its icon set in icons.theme, and omarchy-theme-set-gnome applies it as the GNOME icon theme, which the shell also follows through QT_QPA_PLATFORMTHEME=gtk3. On 4.0.4-1, 15 of the 17 themes with mode = "dark" name a light Yaru variant such as Yaru-blue, Yaru-purple or Yaru-magenta. solitude uses Yaru-sage-dark, and vantablack names Yaru-gray, which does not exist. Light Yaru variants draw status and symbolic icons in dark tones meant for light backgrounds. The bar tints only icons whose name ends in -symbolic, so a tray app advertising any other icon name renders in that dark tone. The matching -dark variants are already installed by yaru-icon-theme. Upstream PR #8900, which would have switched every dark theme to its -dark set, was closed without merging.

Fix

Add a one-file override for the theme you use. A user theme directory with the same name and no .git is copied over the stock one when the theme is set:


theme=$(cat ~/.local/state/omarchy/current/theme.name)
cat /usr/share/omarchy/themes/$theme/icons.theme       # e.g. Yaru-blue
ls -d /usr/share/icons/$(cat /usr/share/omarchy/themes/$theme/icons.theme)-dark
mkdir -p ~/.config/omarchy/themes/$theme
echo "$(cat /usr/share/omarchy/themes/$theme/icons.theme)-dark" > ~/.config/omarchy/themes/$theme/icons.theme
omarchy theme set $theme

The ls -d line must succeed before you write the override. vantablack names Yaru-gray, which does not exist at all, so for it write Yaru-dark instead (check with ls -d /usr/share/icons/Yaru-dark).

A tray app that was already running may keep its old icon until you restart it.

This only helps icons the app looks up in the icon theme. An app that ships its own tray image from its own directory, such as Steam's steam_tray_mono, keeps its colour whatever the theme says.

Verify


gsettings get org.gnome.desktop.interface icon-theme

It prints the -dark variant, and the tray icon is readable on the opaque bar.

Sources

dark-theme-light-yaru-icons-unreadable-tray