NAME¶

 icewm-theme - icewm theme configuration file

SYNOPSIS¶

 $ICEWM_PRIVCFG/theme
 $XDG_CONFIG_HOME/icewm/theme
 $HOME/.icewm/theme
 /etc/X11/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/X11/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.