icewm-theme - Man Page

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.