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