ICEWM-THEME(5) Standards, Environments and Macros ICEWM-THEME(5)

NAME

icewm-theme - icewm theme configuration file

SYNOPSIS

$ICEWM_PRIVCFG/theme
$XDG_CONFIG_HOME/icewm/theme
$HOME/.icewm/theme
/etc/icewm/theme
/usr/share/icewm/theme

DESCRIPTION

The theme file contains the name of the default theme. On startup
icewm reads this file to obtain the theme name, unless icewm was
started with the --theme option. Whenever a different theme is
selected from the icewm Menu then the theme file is overwritten with
the name of the selected theme.

FORMAT

This theme file contains the keyword "Theme", followed by an equals
sign, followed by a double-quoted string with the theme name. The
theme name is the name of the theme directory, followed by a slash,
followed by the theme file.

Usually the theme file is just default.theme, but a theme may have
alternatives. Alternatives are small tweaks of a theme. These are
specified in their own .theme file, which replaces default.theme.

If no theme file exists then icewm will use the default setting of
"Theme="default/default.theme"".

EXAMPLES

Following is my current theme file. You can see from the comments
that icewm(1) keeps a history of the previous ten theme settings.

Theme="Unexicon-towers/default.theme"
#Theme="Unexicon-pedestals/default.theme"
##Theme="Unexicon-penguins/default.theme"
###Theme="Unexicon/default.theme"
####Theme="Squared-for-debian/default.theme"
#####Theme="Squared-grey/default.theme"
######Theme="Squared-green/default.theme"
#######Theme="Penguins/default.theme"
########Theme="Squared-blue/default.theme"
#########Theme="default/default.theme"
##########Theme="yellowmotif/default.theme"

FILES

Locations for the theme file are as follows:

$ICEWM_PRIVCFG/theme
$XDG_CONFIG_HOME/icewm/theme
$HOME/.icewm/theme
/etc/icewm/theme
/usr/share/icewm/theme

The locations are searched in the order listed; the first file found
is read and the remainder ignored.

SEE ALSO

icewm(1), icewm-preferences(5), icewm-prefoverride(5).

AUTHOR

Brian Bidulock <mailto:bidulock@openss7.org>.

LICENSE

IceWM is licensed under the GNU Library General Public License. See
the COPYING file in the distribution.

icewm 3.6.0 2024-06-16 ICEWM-THEME(5)