Fix newly installed apps showing no icon in the launcher
The fix was aimed at the wrong layer for Omarchy 4. I read the launcher source on this machine at /usr/share/omarchy/shell/services/AppLibrary.qml and confirmed it byte for byte against the upstream quattro branch: iconSource() resolves an absolute or file:// value directly, then consults the shell's own icon index, then Qt's Quickshell.iconPath(). That index is a find over $HOME/.icons, $HOME/.local/share/icons, every $XDG_DATA_DIRS icons directory restricted to */apps/* and */devices/*, and /usr/share/pixmaps at depth 1. It never reads GTK's /usr/share/icons/hicolor/icon-theme.cache, so sudo gtk-update-icon-cache -f /usr/share/icons/hicolor cannot be what fixes this on Omarchy 4. Confirmed on this workstation that walker and elephant are not installed (pacman -Q fails for both), and that the cited issue 2547 is titled 'Walker not showing icons for newly installed apps Omarchy 3.1', body says Omarchy 3.1, state CLOSED, so the source supports the record only for Omarchy 3. I also confirmed the shell rebuilds the index on every menu open via refreshIcons() in plugins/menu/Menu.qml and on desktop entry changes debounced by 750 ms, which is why a newly installed app usually needs no command at all. omarchy restart shell is a real route (/usr/share/omarchy/bin/omarchy-restart-shell carries omarchy:examples=omarchy restart shell) and omarchy-restart-walker did exist on the Omarchy 3 master tree, so both commands in the old fix are real even though the first two steps were not. The record's applies_to still lists omarchy-3 and omarchy-4 together and the corrected fix now labels the two branches rather than blending them. I left severity low and frequency very-common unchanged: the symptom stays common on plain Arch GTK desktops, and it is the mechanism rather than the prevalence that was wrong. NOT exercised: I did not install a package or restart the shell on this workstation, and I did not reproduce a blank icon, so the corrected fix is read from source rather than run.
Editing files under /usr/share/applications directly means your change is lost on the next package upgrade. Use the ~/.local/share/applications/ copy shown above instead.
Symptom
Newly installed applications (Firefox, Chrome, GIMP, Brave, Calibre, often AUR packages) appear in the launcher and start correctly, but with a blank or generic icon. Reinstalling the package sometimes fixes it, which makes it look random.
Cause
On Omarchy 4 the launcher and the Apps menu are drawn by the Quickshell shell under /usr/share/omarchy/shell, not by Walker. walker and elephant are not installed at all, so any advice aimed at Walker describes Omarchy 3. Icon lookup lives in /usr/share/omarchy/shell/services/AppLibrary.qml. Its iconSource() resolves, in order: the value itself when it starts with file://, image:// or /, then the shell's own icon index, then Qt's themed lookup through Quickshell.iconPath(), then application-x-executable. That index is built by iconIndexScanCommand(), which shells out to find over $HOME/.icons, $HOME/.local/share/icons and every $XDG_DATA_DIRS entry's icons directory for files under an apps or devices path, plus /usr/share/pixmaps at depth 1. It is a filesystem scan. Nothing in that path reads GTK's binary cache at /usr/share/icons/hicolor/icon-theme.cache, so a stale GTK cache is not the cause of a blank icon in the Omarchy 4 launcher. The index is also rebuilt whenever the desktop entry list changes, debounced by 750 ms, and again on every menu open through refreshIcons(), so a newly installed app normally shows its icon the next time the menu is opened with no command run at all. What does still produce a blank icon on Omarchy 4: the .desktop file has no Icon= line, the name in Icon= matches no file, or the package installed its icon somewhere the scan does not reach, such as a status or mimetypes subdirectory of a theme or a subdirectory below /usr/share/pixmaps. On plain Arch with a GTK based launcher, panel or file chooser, a stale hicolor cache is a genuine cause and gtk-update-icon-cache is the right tool for that layer.
Fix
On Omarchy 4, check the two things that actually decide the icon, then reopen the menu.
**1. Does the desktop entry name an icon?**
grep -n '^Icon=' /usr/share/applications/firefox.desktop
If the line is missing, copy the entry into your own directory and add it there rather than editing the packaged file:
cp /usr/share/applications/firefox.desktop ~/.local/share/applications/
sed -i '/^\[Desktop Entry\]/a Icon=firefox' ~/.local/share/applications/firefox.desktop
**2. Is the icon file somewhere the shell's index looks?**
The Omarchy 4 shell indexes only files under an apps or devices directory inside $HOME/.icons, $HOME/.local/share/icons or any $XDG_DATA_DIRS entry's icons directory, plus /usr/share/pixmaps at depth 1. Search all of those for the name in Icon=:
find /usr/share/icons ~/.local/share/icons ~/.icons \
\( -path '*/apps/*' -o -path '*/devices/*' \) -iname 'firefox.*' 2>/dev/null
find /usr/share/pixmaps -maxdepth 1 -iname 'firefox.*' 2>/dev/null
Nothing found means the package did not install an icon under a name matching Icon=, and no cache rebuild will help. Find what it did install with pacman -Ql <pkg> | grep -E 'icons|pixmaps' and set Icon= to that name, or to the absolute path of the file.
**3. Reopen the menu.**
Press Super+Space, then Apps. The shell rebuilds its icon index on every menu open, and again about 750 ms after the desktop entry list changes, so a newly installed app picks up its icon with no command. Only if it is still blank after reopening:
omarchy restart shell
omarchy restart shell refuses to run while the session is locked.
**Plain Arch, and GTK applications on Omarchy:** GTK's own menus and file choosers do read the binary cache at /usr/share/icons/hicolor/icon-theme.cache, and a package that installed icons without triggering a cache update leaves it stale. Rebuild it there:
sudo gtk-update-icon-cache -f /usr/share/icons/hicolor
That has no effect on the Omarchy 4 launcher, which never reads that file.
**Omarchy 3.x only:** the launcher was Walker, and the restart command was omarchy-restart-walker.
Verify
Open the Omarchy menu with Super+Space, go to Apps, and the application shows its real icon. If it does not, find in step 2 prints the icon file whose basename matches the Icon= value, and journalctl --user -b shows no QML QQuickImage ... Cannot open line naming it. On plain Arch or for GTK applications, gtk-update-icon-cache -f exits 0 and the GTK application menu picks the icon up.