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

Fix nerd-font icons rendering as empty boxes or tofu in the bar and menus

omarchyarchendeavouroscachyosmanjarohyprlandwayland
AUDITED Audited against its sources and confirmed accurate.

Symptom

Menu and bar entries show a broken-character box instead of an icon, while other entries in the same menu render fine. Classic case: the Update > Omarchy row shows tofu where every other row (Channel, Config, Extra Themes) has a proper glyph. The glyph really is present in the font file (fc-scan and fontTools both find it), so it looks like a missing-glyph bug that isn't.

Cause

Stale fontconfig caches. Old cache-format directories (cache-7, cache-9, cache-10, ...) left behind by previous fontconfig upgrades cause the cache builder to produce an incomplete charset bitmap for a font. In the canonical report, omarchy.ttf indexed only its ASCII codepoints and silently dropped the U+E900 private-use entry, so pango fell back to a non-nerd font and drew tofu. A related but distinct cause is a codepoint from the old Nerd Font v2 private-use range that the v2-to-v3 remap relocated. Those genuinely do not resolve on current Nerd Font builds.

Fix

Inspect the cached charset. A missing page means a stale cache, not a missing glyph:


fc-list -v omarchy | grep -A5 charset
# a healthy result has a line starting  00e9:  for U+E900

Nuke every cache generation and rebuild:


rm -rf ~/.cache/fontconfig/*
fc-cache -fv

Then restart whatever draws the glyph:


omarchy restart shell     # Omarchy 4
# omarchy restart walker  # Omarchy 3.x

If a system-wide cache is also stale:


sudo fc-cache -fv

And confirm the Nerd Font is actually installed:


fc-list | grep -i 'nerd font' | head

Verify

fc-list :charset=e900 family prints omarchy, fc-list -v omarchy | grep -A5 charset now includes the 00e9: page, and pango-view --text=$'' renders a glyph instead of a box.

Sources

nerd-font-icons-render-as-boxes-stale-fontconfig-cache