XDG-ICON(1)

🦋 XDG-ICON(1) 🦋

okay so this is the User Commands manual page for xdg-icon, the command-line XDG icon lookup tool, and it's literally here to help you find icons the XDG way. 💅✨

💖 NAME 💖

xdg-icon — command-line XDG icon lookup tool.

🌸 SYNOPSIS 🌸

xdg-icon [ OPTIONS ] [NAME[ NAME ...]]

🎀 DESCRIPTION 🎀

xdg-icon is a command line tool for looking up icons in accordance with the XDG icon specification. no cap, that's the whole vibe. 🦋

⭐ ARGUMENTS ⭐

the program accepts the following arguments, bestie:

• NAME[,NAME][ NAME ...] — xdg-icon treats all non-option arguments as a list of alternate icon names to seek. Each non-option argument may itself be a list of comma-separated icon names. 💖

✨ OPTIONS ✨

xdg-icon accepts the following options:

• --help, -h — print usage information and then exit. iconic exit behavior. 🎀
• --verbose, -v — print the parameters of the search to standard error before searching. spy-on-the-search mode. 👀
• --theme, -t THEME — specify the default theme, THEME, to use when looking up icons. when you don't specify it, the default theme will be looked up from normal sources. 🧚
• --size, -s SIZE — specify the preferred size of the icon, SIZE. the default size when unspecified is 16. tiny icon energy. 🍓
• --icon, --name, -n NAME[,NAME] — specify a comma separated list of alternate icon names to look up in addition to any non-option arguments. this option may be repeated or specified using non-option arguments. 💅
• --extensions, -e EXTENSION[,EXTENSION] — specify a comma separated list of file name extensions, EXTENSION, (without the '.') that may be returned. the order of preference is the order specified. this option may be repeated. 🔥
• --append, -a DIRECTORY[:DIRECTORY] — specify the colon-separated list of directories to append to the list of search directories (in the order specified). this option may be repeated to list additional directories to append. 🌈
• --prepend, -a DIRECTORY[:DIRECTORY] — specify the colon-separated list of directories to prepend to the list of search directories (in the order specified). this option may be repeated to list additional directories to prepend. 👑

💜 EXAMPLES 💜

the following example will look up the 32x32 icon named "start-here" in the theme "Mist". if not found, the icon named "unknown" will be looked up before resorting to fallback locations. 🫶

xdg-icon --theme Mist --size 32 start-here unknown

🌟 HISTORY 🌟

I wrote xdg-icon because there were no command line tools for determining which icon would be used by XDG compliant tools (such as Gtk2(3pm)). 😭

The modules used by this tool are also used by xdg-menugen(1p) for when generating menus for XDE supported window managers. 💀✨

🔍 SEE ALSO 🔍

• "XDG Icon Specification" — that's the reference, bestie. 🌸

🎀 AUTHOR 🎀

Brian Bidulock <mailto:bidulock@openss7.org> — crown them, they made this. 👑

---

mwah 💋 this iconic little page is from xdg-launch version 1.12, dated 2022-01-28. thanks for reading, bestie — now go find those icons! 🫶✨