xdg-icon-resource — command line tool for (un)installing icon resources
xdg-icon-resource
install [--noupdate
] [--theme
] [theme
--context
] [context
--size
] { size
--user
| --system
} icon-file
[icon-name
]
xdg-icon-resource
uninstall [--noupdate
] [--theme
] [theme
--context
] [context
--size
] { size
--user
| --system
} icon-name
xdg-icon-resource
forceupdate [--theme
] { --user | --system }theme
xdg-icon-resource
{ --help
| --manual
| --version
}
The xdg-icon-resource program can be used to install icon resources into the desktop icon system in order to illustrate menu entries, to depict desktop icons or to graphically represent file types.
The desktop icon system identifies icons by name. Depending on the required size, the choice of icon theme and the context in which the icon is used, the desktop icon system locates an appropriate icon resource to depict an icon. Icon resources can be XPM files, PNG files or SVG files.
The desktop icon system works according to the XDG Icon Theme Specification at http://www.freedesktop.org/Standards/icon-theme-spec
icon-file
to the desktop icon system under the name
icon-name
. If
icon-name
is not provided the name is
derived from icon-file
.
The icon file must have
.png, .xpm or
.svg as extension. If a corresponding
.icon file exists in the same location as icon-file
it will be installed as well.
icon-name
from the desktop icon system.
--noupdate
option.
--noupdate
--theme
theme
theme
. If no theme is specified the
icons will be installed as part of the default hicolor theme.
Applications may install icons under multiple themes but should
at least install icons for the default hicolor theme.
--context
context
--size
size
--user
--system
--help
--manual
--version
An exit code of 0 indicates success while a non-zero exit code indicates failure. The following failure codes can be returned:
1
2
3
4
To install an icon resource to depict a launcher for the application myfoobar one can use:
xdg-icon-resource install --system --size 64 myfoobar.png
To install an icon for a new application/x-foobar file type one can use:
xdg-icon-resource install --system --context mimetypes --size 48 ./mime-foobar-48.png application-x-foobar.png xdg-icon-resource install --system --context mimetypes --size 64 ./mime-foobar-64.png application-x-foobar.png
This will install two icons with the name application-x-foobar.png but with different sizes. The icons will be installed for use by all users.