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.