Standards, Environments and Macros

# 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.

Standards, Environments and Macros