Skip to main content
Icon lookup, .desktop parsing, installed app list, and launch helpers.

Icon lookup

Search order:
  1. Preferred themes (Papirus, Breeze, Adwaita, hicolor, etc.) with SVG preferred over PNG
  2. Remaining themes on disk
  3. Pixmaps directories
  4. .desktop Icon= fallback (exact filename, then directory scan for AppImages)
Base paths include XDG data home, /usr/share/icons, and Flatpak export trees. Use findIconInTheme when a caller needs one named runtime theme or an absolute theme directory. It prefers SVG and leaves ownership of the returned path with the caller. Ordinary app icon lookup keeps the normal desktop theme order.

Desktop entries

Locale-aware Name and Comment resolution follows XDG rules.

Application list

AppDirWatcher uses otter-utils inotify on XDG applications directories.

Launcher

Expands %f, %u, %i exec fields. Terminal=true entries spawn through detected terminal ($TERMINAL, then foot, otter-term, kitty, etc.).