From ArchWiki
Jump to: navigation, search

The freedesktop project provides the Icon Theme Specification, which applies to most linux desktop environments and tries to unify the look of a whole bunch of icons in an icon-theme. Freedesktop also provides the Icon Naming Specification, which defines a standard naming scheme for icons believed to be installed on any system. The default theme hicolor should include them all.


Icons and emblems

To append a custom icon to an existing icon theme xdg-icon-resource can be used. This will resize and copy the icon to $HOME/.local/share/icons/. With this method, custom emblems can also be added. Examples:

$ xdg-icon-resource install --size 128 --context emblems archuser-example.png # add as emblem
$ xdg-icon-resource install --size 128 archuser-example.png # add as normal icon

Mime type icons

Todays file managers do not rely on the traditional mime type which file --mime outputs. Instead definitions from /usr/share/mime/ are used. Calling an icon according to the definition found there and copying it to ~/.local/share/icons will cause the file manager to display the custom mime type icon. This command illustrates the method:

Creates a custom icon for keepass database files (*.kdb)
# grep kdb /usr/share/mime/globs | egrep -o '.+\/[^:]+' | tr '/' '-'
application-x-keepass ;# rename your icon according to this output
xdg-icon-resource install --size 128 --context mimetypes application-x-keepass.png

Icon themes

Tip: It is recommended to install the hicolor-icon-theme package as many programs will deposit their icons in /usr/share/icons/hicolor and most other icon themes will inherit icons from the Hicolor icon theme.

From a package


If you cannot find a package for the icon theme you are looking for, you will need to install it manually.

  • Then navigate to the directory which contains the icon pack and extract it. Example tar -xzf /home/user/downloads/icon-pack.tar.gz.
  • Move the extracted folder containing the icons to either ~/.icons or ~/.local/share/icons (user only) or to /usr/share/icons (systemwide).
  • Optional: run gtk-update-icon-cache -f -t ~/.icons/<theme_name> to update the icon cache.

fstab / gvfs

According to this document file managers using GVFS (like Gnome Files or Thunar) can display icons for custom locations, like NFS shares. All you need are some extended mount options inside /etc/fstab with icon names supported by your selected icon theme:

hostname:/ /mnt/ nfs4 defaults,_netdev,user,rw,exec,comment=x-gvfs-show,x-gvfs-name=Network%20Attached%20Storage,x-gvfs-icon=network-server,x-gvfs-symbolic-icon=network-server,timeo=14,noatime 0 0

Xfce icons

Tango-edit-cut.pngThis section is being considered for removal.Tango-edit-cut.png

Reason: Back in 2014, Xfce was searching for non-standard icon definitions for a number of menu items such as the Suspend action button and the Mail Reader launch button. This meant that when using the GNOME icon theme, these actions would have no icon. As of 2018, this has been mostly, if not completely, fixed. [1] [2] [3] [4] [5] (Discuss in Talk:Icons#)

Not all icon themes provide a complete set of icons for the Xfce environment. Listed below are a number of icon themes that do.