Sophie: icewm-1:1.5.4-2.mga7 armv7hl

icewm-1.5.4-2.mga7.armv7hl.rpm

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<!--[if IE]><meta http-equiv="X-UA-Compatible" content="IE=edge"><![endif]-->
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="generator" content="Asciidoctor 1.5.6.1">
<meta name="author" content="Marko Macek">
<title>IceWM Manual</title>
<style>
/* Asciidoctor default stylesheet | MIT License | http://asciidoctor.org */
/* Remove comment around @import statement below when using as a custom stylesheet */
/*@import "https://fonts.googleapis.com/css?family=Open+Sans:300,300italic,400,400italic,600,600italic%7CNoto+Serif:400,400italic,700,700italic%7CDroid+Sans+Mono:400,700";*/
article,aside,details,figcaption,figure,footer,header,hgroup,main,nav,section,summary{display:block}
audio,canvas,video{display:inline-block}
audio:not([controls]){display:none;height:0}
[hidden],template{display:none}
script{display:none!important}
html{font-family:sans-serif;-ms-text-size-adjust:100%;-webkit-text-size-adjust:100%}
a{background:transparent}
a:focus{outline:thin dotted}
a:active,a:hover{outline:0}
h1{font-size:2em;margin:.67em 0}
abbr[title]{border-bottom:1px dotted}
b,strong{font-weight:bold}
dfn{font-style:italic}
hr{-moz-box-sizing:content-box;box-sizing:content-box;height:0}
mark{background:#ff0;color:#000}
code,kbd,pre,samp{font-family:monospace;font-size:1em}
pre{white-space:pre-wrap}
q{quotes:"\201C" "\201D" "\2018" "\2019"}
small{font-size:80%}
sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}
sup{top:-.5em}
sub{bottom:-.25em}
img{border:0}
svg:not(:root){overflow:hidden}
figure{margin:0}
fieldset{border:1px solid silver;margin:0 2px;padding:.35em .625em .75em}
legend{border:0;padding:0}
button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}
button,input{line-height:normal}
button,select{text-transform:none}
button,html input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer}
button[disabled],html input[disabled]{cursor:default}
input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0}
input[type="search"]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}
input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}
button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}
textarea{overflow:auto;vertical-align:top}
table{border-collapse:collapse;border-spacing:0}
*,*:before,*:after{-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}
html,body{font-size:100%}
body{background:#fff;color:rgba(0,0,0,.8);padding:0;margin:0;font-family:"Noto Serif","DejaVu Serif",serif;font-weight:400;font-style:normal;line-height:1;position:relative;cursor:auto;tab-size:4;-moz-osx-font-smoothing:grayscale;-webkit-font-smoothing:antialiased}
a:hover{cursor:pointer}
img,object,embed{max-width:100%;height:auto}
object,embed{height:100%}
img{-ms-interpolation-mode:bicubic}
.left{float:left!important}
.right{float:right!important}
.text-left{text-align:left!important}
.text-right{text-align:right!important}
.text-center{text-align:center!important}
.text-justify{text-align:justify!important}
.hide{display:none}
img,object,svg{display:inline-block;vertical-align:middle}
textarea{height:auto;min-height:50px}
select{width:100%}
.center{margin-left:auto;margin-right:auto}
.spread{width:100%}
p.lead,.paragraph.lead>p,#preamble>.sectionbody>.paragraph:first-of-type p{font-size:1.21875em;line-height:1.6}
.subheader,.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{line-height:1.45;color:#7a2518;font-weight:400;margin-top:0;margin-bottom:.25em}
div,dl,dt,dd,ul,ol,li,h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6,pre,form,p,blockquote,th,td{margin:0;padding:0;direction:ltr}
a{color:#2156a5;text-decoration:underline;line-height:inherit}
a:hover,a:focus{color:#1d4b8f}
a img{border:none}
p{font-family:inherit;font-weight:400;font-size:1em;line-height:1.6;margin-bottom:1.25em;text-rendering:optimizeLegibility}
p aside{font-size:.875em;line-height:1.35;font-style:italic}
h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{font-family:"Open Sans","DejaVu Sans",sans-serif;font-weight:300;font-style:normal;color:#ba3925;text-rendering:optimizeLegibility;margin-top:1em;margin-bottom:.5em;line-height:1.0125em}
h1 small,h2 small,h3 small,#toctitle small,.sidebarblock>.content>.title small,h4 small,h5 small,h6 small{font-size:60%;color:#e99b8f;line-height:0}
h1{font-size:2.125em}
h2{font-size:1.6875em}
h3,#toctitle,.sidebarblock>.content>.title{font-size:1.375em}
h4,h5{font-size:1.125em}
h6{font-size:1em}
hr{border:solid #ddddd8;border-width:1px 0 0;clear:both;margin:1.25em 0 1.1875em;height:0}
em,i{font-style:italic;line-height:inherit}
strong,b{font-weight:bold;line-height:inherit}
small{font-size:60%;line-height:inherit}
code{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;color:rgba(0,0,0,.9)}
ul,ol,dl{font-size:1em;line-height:1.6;margin-bottom:1.25em;list-style-position:outside;font-family:inherit}
ul,ol{margin-left:1.5em}
ul li ul,ul li ol{margin-left:1.25em;margin-bottom:0;font-size:1em}
ul.square li ul,ul.circle li ul,ul.disc li ul{list-style:inherit}
ul.square{list-style-type:square}
ul.circle{list-style-type:circle}
ul.disc{list-style-type:disc}
ol li ul,ol li ol{margin-left:1.25em;margin-bottom:0}
dl dt{margin-bottom:.3125em;font-weight:bold}
dl dd{margin-bottom:1.25em}
abbr,acronym{text-transform:uppercase;font-size:90%;color:rgba(0,0,0,.8);border-bottom:1px dotted #ddd;cursor:help}
abbr{text-transform:none}
blockquote{margin:0 0 1.25em;padding:.5625em 1.25em 0 1.1875em;border-left:1px solid #ddd}
blockquote cite{display:block;font-size:.9375em;color:rgba(0,0,0,.6)}
blockquote cite:before{content:"\2014 \0020"}
blockquote cite a,blockquote cite a:visited{color:rgba(0,0,0,.6)}
blockquote,blockquote p{line-height:1.6;color:rgba(0,0,0,.85)}
@media only screen and (min-width:768px){h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2}
h1{font-size:2.75em}
h2{font-size:2.3125em}
h3,#toctitle,.sidebarblock>.content>.title{font-size:1.6875em}
h4{font-size:1.4375em}}
table{background:#fff;margin-bottom:1.25em;border:solid 1px #dedede}
table thead,table tfoot{background:#f7f8f7;font-weight:bold}
table thead tr th,table thead tr td,table tfoot tr th,table tfoot tr td{padding:.5em .625em .625em;font-size:inherit;color:rgba(0,0,0,.8);text-align:left}
table tr th,table tr td{padding:.5625em .625em;font-size:inherit;color:rgba(0,0,0,.8)}
table tr.even,table tr.alt,table tr:nth-of-type(even){background:#f8f8f7}
table thead tr th,table tfoot tr th,table tbody tr td,table tr td,table tfoot tr td{display:table-cell;line-height:1.6}
h1,h2,h3,#toctitle,.sidebarblock>.content>.title,h4,h5,h6{line-height:1.2;word-spacing:-.05em}
h1 strong,h2 strong,h3 strong,#toctitle strong,.sidebarblock>.content>.title strong,h4 strong,h5 strong,h6 strong{font-weight:400}
.clearfix:before,.clearfix:after,.float-group:before,.float-group:after{content:" ";display:table}
.clearfix:after,.float-group:after{clear:both}
*:not(pre)>code{font-size:.9375em;font-style:normal!important;letter-spacing:0;padding:.1em .5ex;word-spacing:-.15em;background-color:#f7f7f8;-webkit-border-radius:4px;border-radius:4px;line-height:1.45;text-rendering:optimizeSpeed;word-wrap:break-word}
*:not(pre)>code.nobreak{word-wrap:normal}
*:not(pre)>code.nowrap{white-space:nowrap}
pre,pre>code{line-height:1.45;color:rgba(0,0,0,.9);font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;font-weight:400;text-rendering:optimizeSpeed}
em em{font-style:normal}
strong strong{font-weight:400}
.keyseq{color:rgba(51,51,51,.8)}
kbd{font-family:"Droid Sans Mono","DejaVu Sans Mono",monospace;display:inline-block;color:rgba(0,0,0,.8);font-size:.65em;line-height:1.45;background-color:#f7f7f7;border:1px solid #ccc;-webkit-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em white inset;box-shadow:0 1px 0 rgba(0,0,0,.2),0 0 0 .1em #fff inset;margin:0 .15em;padding:.2em .5em;vertical-align:middle;position:relative;top:-.1em;white-space:nowrap}
.keyseq kbd:first-child{margin-left:0}
.keyseq kbd:last-child{margin-right:0}
.menuseq,.menuref{color:#000}
.menuseq b:not(.caret),.menuref{font-weight:inherit}
.menuseq{word-spacing:-.02em}
.menuseq b.caret{font-size:1.25em;line-height:.8}
.menuseq i.caret{font-weight:bold;text-align:center;width:.45em}
b.button:before,b.button:after{position:relative;top:-1px;font-weight:400}
b.button:before{content:"[";padding:0 3px 0 2px}
b.button:after{content:"]";padding:0 2px 0 3px}
p a>code:hover{color:rgba(0,0,0,.9)}
#header,#content,#footnotes,#footer{width:100%;margin-left:auto;margin-right:auto;margin-top:0;margin-bottom:0;max-width:62.5em;*zoom:1;position:relative;padding-left:.9375em;padding-right:.9375em}
#header:before,#header:after,#content:before,#content:after,#footnotes:before,#footnotes:after,#footer:before,#footer:after{content:" ";display:table}
#header:after,#content:after,#footnotes:after,#footer:after{clear:both}
#content{margin-top:1.25em}
#content:before{content:none}
#header>h1:first-child{color:rgba(0,0,0,.85);margin-top:2.25rem;margin-bottom:0}
#header>h1:first-child+#toc{margin-top:8px;border-top:1px solid #ddddd8}
#header>h1:only-child,body.toc2 #header>h1:nth-last-child(2){border-bottom:1px solid #ddddd8;padding-bottom:8px}
#header .details{border-bottom:1px solid #ddddd8;line-height:1.45;padding-top:.25em;padding-bottom:.25em;padding-left:.25em;color:rgba(0,0,0,.6);display:-ms-flexbox;display:-webkit-flex;display:flex;-ms-flex-flow:row wrap;-webkit-flex-flow:row wrap;flex-flow:row wrap}
#header .details span:first-child{margin-left:-.125em}
#header .details span.email a{color:rgba(0,0,0,.85)}
#header .details br{display:none}
#header .details br+span:before{content:"\00a0\2013\00a0"}
#header .details br+span.author:before{content:"\00a0\22c5\00a0";color:rgba(0,0,0,.85)}
#header .details br+span#revremark:before{content:"\00a0|\00a0"}
#header #revnumber{text-transform:capitalize}
#header #revnumber:after{content:"\00a0"}
#content>h1:first-child:not([class]){color:rgba(0,0,0,.85);border-bottom:1px solid #ddddd8;padding-bottom:8px;margin-top:0;padding-top:1rem;margin-bottom:1.25rem}
#toc{border-bottom:1px solid #efefed;padding-bottom:.5em}
#toc>ul{margin-left:.125em}
#toc ul.sectlevel0>li>a{font-style:italic}
#toc ul.sectlevel0 ul.sectlevel1{margin:.5em 0}
#toc ul{font-family:"Open Sans","DejaVu Sans",sans-serif;list-style-type:none}
#toc li{line-height:1.3334;margin-top:.3334em}
#toc a{text-decoration:none}
#toc a:active{text-decoration:underline}
#toctitle{color:#7a2518;font-size:1.2em}
@media only screen and (min-width:768px){#toctitle{font-size:1.375em}
body.toc2{padding-left:15em;padding-right:0}
#toc.toc2{margin-top:0!important;background-color:#f8f8f7;position:fixed;width:15em;left:0;top:0;border-right:1px solid #efefed;border-top-width:0!important;border-bottom-width:0!important;z-index:1000;padding:1.25em 1em;height:100%;overflow:auto}
#toc.toc2 #toctitle{margin-top:0;margin-bottom:.8rem;font-size:1.2em}
#toc.toc2>ul{font-size:.9em;margin-bottom:0}
#toc.toc2 ul ul{margin-left:0;padding-left:1em}
#toc.toc2 ul.sectlevel0 ul.sectlevel1{padding-left:0;margin-top:.5em;margin-bottom:.5em}
body.toc2.toc-right{padding-left:0;padding-right:15em}
body.toc2.toc-right #toc.toc2{border-right-width:0;border-left:1px solid #efefed;left:auto;right:0}}
@media only screen and (min-width:1280px){body.toc2{padding-left:20em;padding-right:0}
#toc.toc2{width:20em}
#toc.toc2 #toctitle{font-size:1.375em}
#toc.toc2>ul{font-size:.95em}
#toc.toc2 ul ul{padding-left:1.25em}
body.toc2.toc-right{padding-left:0;padding-right:20em}}
#content #toc{border-style:solid;border-width:1px;border-color:#e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;-webkit-border-radius:4px;border-radius:4px}
#content #toc>:first-child{margin-top:0}
#content #toc>:last-child{margin-bottom:0}
#footer{max-width:100%;background-color:rgba(0,0,0,.8);padding:1.25em}
#footer-text{color:rgba(255,255,255,.8);line-height:1.44}
.sect1{padding-bottom:.625em}
@media only screen and (min-width:768px){.sect1{padding-bottom:1.25em}}
.sect1+.sect1{border-top:1px solid #efefed}
#content h1>a.anchor,h2>a.anchor,h3>a.anchor,#toctitle>a.anchor,.sidebarblock>.content>.title>a.anchor,h4>a.anchor,h5>a.anchor,h6>a.anchor{position:absolute;z-index:1001;width:1.5ex;margin-left:-1.5ex;display:block;text-decoration:none!important;visibility:hidden;text-align:center;font-weight:400}
#content h1>a.anchor:before,h2>a.anchor:before,h3>a.anchor:before,#toctitle>a.anchor:before,.sidebarblock>.content>.title>a.anchor:before,h4>a.anchor:before,h5>a.anchor:before,h6>a.anchor:before{content:"\00A7";font-size:.85em;display:block;padding-top:.1em}
#content h1:hover>a.anchor,#content h1>a.anchor:hover,h2:hover>a.anchor,h2>a.anchor:hover,h3:hover>a.anchor,#toctitle:hover>a.anchor,.sidebarblock>.content>.title:hover>a.anchor,h3>a.anchor:hover,#toctitle>a.anchor:hover,.sidebarblock>.content>.title>a.anchor:hover,h4:hover>a.anchor,h4>a.anchor:hover,h5:hover>a.anchor,h5>a.anchor:hover,h6:hover>a.anchor,h6>a.anchor:hover{visibility:visible}
#content h1>a.link,h2>a.link,h3>a.link,#toctitle>a.link,.sidebarblock>.content>.title>a.link,h4>a.link,h5>a.link,h6>a.link{color:#ba3925;text-decoration:none}
#content h1>a.link:hover,h2>a.link:hover,h3>a.link:hover,#toctitle>a.link:hover,.sidebarblock>.content>.title>a.link:hover,h4>a.link:hover,h5>a.link:hover,h6>a.link:hover{color:#a53221}
.audioblock,.imageblock,.literalblock,.listingblock,.stemblock,.videoblock{margin-bottom:1.25em}
.admonitionblock td.content>.title,.audioblock>.title,.exampleblock>.title,.imageblock>.title,.listingblock>.title,.literalblock>.title,.stemblock>.title,.openblock>.title,.paragraph>.title,.quoteblock>.title,table.tableblock>.title,.verseblock>.title,.videoblock>.title,.dlist>.title,.olist>.title,.ulist>.title,.qlist>.title,.hdlist>.title{text-rendering:optimizeLegibility;text-align:left;font-family:"Noto Serif","DejaVu Serif",serif;font-size:1rem;font-style:italic}
table.tableblock>caption.title{white-space:nowrap;overflow:visible;max-width:0}
.paragraph.lead>p,#preamble>.sectionbody>.paragraph:first-of-type p{color:rgba(0,0,0,.85)}
table.tableblock #preamble>.sectionbody>.paragraph:first-of-type p{font-size:inherit}
.admonitionblock>table{border-collapse:separate;border:0;background:none;width:100%}
.admonitionblock>table td.icon{text-align:center;width:80px}
.admonitionblock>table td.icon img{max-width:initial}
.admonitionblock>table td.icon .title{font-weight:bold;font-family:"Open Sans","DejaVu Sans",sans-serif;text-transform:uppercase}
.admonitionblock>table td.content{padding-left:1.125em;padding-right:1.25em;border-left:1px solid #ddddd8;color:rgba(0,0,0,.6)}
.admonitionblock>table td.content>:last-child>:last-child{margin-bottom:0}
.exampleblock>.content{border-style:solid;border-width:1px;border-color:#e6e6e6;margin-bottom:1.25em;padding:1.25em;background:#fff;-webkit-border-radius:4px;border-radius:4px}
.exampleblock>.content>:first-child{margin-top:0}
.exampleblock>.content>:last-child{margin-bottom:0}
.sidebarblock{border-style:solid;border-width:1px;border-color:#e0e0dc;margin-bottom:1.25em;padding:1.25em;background:#f8f8f7;-webkit-border-radius:4px;border-radius:4px}
.sidebarblock>:first-child{margin-top:0}
.sidebarblock>:last-child{margin-bottom:0}
.sidebarblock>.content>.title{color:#7a2518;margin-top:0;text-align:center}
.exampleblock>.content>:last-child>:last-child,.exampleblock>.content .olist>ol>li:last-child>:last-child,.exampleblock>.content .ulist>ul>li:last-child>:last-child,.exampleblock>.content .qlist>ol>li:last-child>:last-child,.sidebarblock>.content>:last-child>:last-child,.sidebarblock>.content .olist>ol>li:last-child>:last-child,.sidebarblock>.content .ulist>ul>li:last-child>:last-child,.sidebarblock>.content .qlist>ol>li:last-child>:last-child{margin-bottom:0}
.literalblock pre,.listingblock pre:not(.highlight),.listingblock pre[class="highlight"],.listingblock pre[class^="highlight "],.listingblock pre.CodeRay,.listingblock pre.prettyprint{background:#f7f7f8}
.sidebarblock .literalblock pre,.sidebarblock .listingblock pre:not(.highlight),.sidebarblock .listingblock pre[class="highlight"],.sidebarblock .listingblock pre[class^="highlight "],.sidebarblock .listingblock pre.CodeRay,.sidebarblock .listingblock pre.prettyprint{background:#f2f1f1}
.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{-webkit-border-radius:4px;border-radius:4px;word-wrap:break-word;padding:1em;font-size:.8125em}
.literalblock pre.nowrap,.literalblock pre[class].nowrap,.listingblock pre.nowrap,.listingblock pre[class].nowrap{overflow-x:auto;white-space:pre;word-wrap:normal}
@media only screen and (min-width:768px){.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:.90625em}}
@media only screen and (min-width:1280px){.literalblock pre,.literalblock pre[class],.listingblock pre,.listingblock pre[class]{font-size:1em}}
.literalblock.output pre{color:#f7f7f8;background-color:rgba(0,0,0,.9)}
.listingblock pre.highlightjs{padding:0}
.listingblock pre.highlightjs>code{padding:1em;-webkit-border-radius:4px;border-radius:4px}
.listingblock pre.prettyprint{border-width:0}
.listingblock>.content{position:relative}
.listingblock code[data-lang]:before{display:none;content:attr(data-lang);position:absolute;font-size:.75em;top:.425rem;right:.5rem;line-height:1;text-transform:uppercase;color:#999}
.listingblock:hover code[data-lang]:before{display:block}
.listingblock.terminal pre .command:before{content:attr(data-prompt);padding-right:.5em;color:#999}
.listingblock.terminal pre .command:not([data-prompt]):before{content:"$"}
table.pyhltable{border-collapse:separate;border:0;margin-bottom:0;background:none}
table.pyhltable td{vertical-align:top;padding-top:0;padding-bottom:0;line-height:1.45}
table.pyhltable td.code{padding-left:.75em;padding-right:0}
pre.pygments .lineno,table.pyhltable td:not(.code){color:#999;padding-left:0;padding-right:.5em;border-right:1px solid #ddddd8}
pre.pygments .lineno{display:inline-block;margin-right:.25em}
table.pyhltable .linenodiv{background:none!important;padding-right:0!important}
.quoteblock{margin:0 1em 1.25em 1.5em;display:table}
.quoteblock>.title{margin-left:-1.5em;margin-bottom:.75em}
.quoteblock blockquote,.quoteblock blockquote p{color:rgba(0,0,0,.85);font-size:1.15rem;line-height:1.75;word-spacing:.1em;letter-spacing:0;font-style:italic;text-align:justify}
.quoteblock blockquote{margin:0;padding:0;border:0}
.quoteblock blockquote:before{content:"\201c";float:left;font-size:2.75em;font-weight:bold;line-height:.6em;margin-left:-.6em;color:#7a2518;text-shadow:0 1px 2px rgba(0,0,0,.1)}
.quoteblock blockquote>.paragraph:last-child p{margin-bottom:0}
.quoteblock .attribution{margin-top:.5em;margin-right:.5ex;text-align:right}
.quoteblock .quoteblock{margin-left:0;margin-right:0;padding:.5em 0;border-left:3px solid rgba(0,0,0,.6)}
.quoteblock .quoteblock blockquote{padding:0 0 0 .75em}
.quoteblock .quoteblock blockquote:before{display:none}
.verseblock{margin:0 1em 1.25em 1em}
.verseblock pre{font-family:"Open Sans","DejaVu Sans",sans;font-size:1.15rem;color:rgba(0,0,0,.85);font-weight:300;text-rendering:optimizeLegibility}
.verseblock pre strong{font-weight:400}
.verseblock .attribution{margin-top:1.25rem;margin-left:.5ex}
.quoteblock .attribution,.verseblock .attribution{font-size:.9375em;line-height:1.45;font-style:italic}
.quoteblock .attribution br,.verseblock .attribution br{display:none}
.quoteblock .attribution cite,.verseblock .attribution cite{display:block;letter-spacing:-.025em;color:rgba(0,0,0,.6)}
.quoteblock.abstract{margin:0 0 1.25em 0;display:block}
.quoteblock.abstract blockquote,.quoteblock.abstract blockquote p{text-align:left;word-spacing:0}
.quoteblock.abstract blockquote:before,.quoteblock.abstract blockquote p:first-of-type:before{display:none}
table.tableblock{max-width:100%;border-collapse:separate}
table.tableblock td>.paragraph:last-child p>p:last-child,table.tableblock th>p:last-child,table.tableblock td>p:last-child{margin-bottom:0}
table.tableblock,th.tableblock,td.tableblock{border:0 solid #dedede}
table.grid-all>thead>tr>.tableblock,table.grid-all>tbody>tr>.tableblock{border-width:0 1px 1px 0}
table.grid-all>tfoot>tr>.tableblock{border-width:1px 1px 0 0}
table.grid-cols>*>tr>.tableblock{border-width:0 1px 0 0}
table.grid-rows>thead>tr>.tableblock,table.grid-rows>tbody>tr>.tableblock{border-width:0 0 1px 0}
table.grid-rows>tfoot>tr>.tableblock{border-width:1px 0 0 0}
table.grid-all>*>tr>.tableblock:last-child,table.grid-cols>*>tr>.tableblock:last-child{border-right-width:0}
table.grid-all>tbody>tr:last-child>.tableblock,table.grid-all>thead:last-child>tr>.tableblock,table.grid-rows>tbody>tr:last-child>.tableblock,table.grid-rows>thead:last-child>tr>.tableblock{border-bottom-width:0}
table.frame-all{border-width:1px}
table.frame-sides{border-width:0 1px}
table.frame-topbot{border-width:1px 0}
th.halign-left,td.halign-left{text-align:left}
th.halign-right,td.halign-right{text-align:right}
th.halign-center,td.halign-center{text-align:center}
th.valign-top,td.valign-top{vertical-align:top}
th.valign-bottom,td.valign-bottom{vertical-align:bottom}
th.valign-middle,td.valign-middle{vertical-align:middle}
table thead th,table tfoot th{font-weight:bold}
tbody tr th{display:table-cell;line-height:1.6;background:#f7f8f7}
tbody tr th,tbody tr th p,tfoot tr th,tfoot tr th p{color:rgba(0,0,0,.8);font-weight:bold}
p.tableblock>code:only-child{background:none;padding:0}
p.tableblock{font-size:1em}
td>div.verse{white-space:pre}
ol{margin-left:1.75em}
ul li ol{margin-left:1.5em}
dl dd{margin-left:1.125em}
dl dd:last-child,dl dd:last-child>:last-child{margin-bottom:0}
ol>li p,ul>li p,ul dd,ol dd,.olist .olist,.ulist .ulist,.ulist .olist,.olist .ulist{margin-bottom:.625em}
ul.checklist,ul.none,ol.none,ul.no-bullet,ol.no-bullet,ol.unnumbered,ul.unstyled,ol.unstyled{list-style-type:none}
ul.no-bullet,ol.no-bullet,ol.unnumbered{margin-left:.625em}
ul.unstyled,ol.unstyled{margin-left:0}
ul.checklist{margin-left:.625em}
ul.checklist li>p:first-child>.fa-square-o:first-child,ul.checklist li>p:first-child>.fa-check-square-o:first-child{width:1.25em;font-size:.8em;position:relative;bottom:.125em}
ul.checklist li>p:first-child>input[type="checkbox"]:first-child{margin-right:.25em}
ul.inline{margin:0 auto .625em auto;margin-left:-1.375em;margin-right:0;padding:0;list-style:none;overflow:hidden}
ul.inline>li{list-style:none;float:left;margin-left:1.375em;display:block}
ul.inline>li>*{display:block}
.unstyled dl dt{font-weight:400;font-style:normal}
ol.arabic{list-style-type:decimal}
ol.decimal{list-style-type:decimal-leading-zero}
ol.loweralpha{list-style-type:lower-alpha}
ol.upperalpha{list-style-type:upper-alpha}
ol.lowerroman{list-style-type:lower-roman}
ol.upperroman{list-style-type:upper-roman}
ol.lowergreek{list-style-type:lower-greek}
.hdlist>table,.colist>table{border:0;background:none}
.hdlist>table>tbody>tr,.colist>table>tbody>tr{background:none}
td.hdlist1,td.hdlist2{vertical-align:top;padding:0 .625em}
td.hdlist1{font-weight:bold;padding-bottom:1.25em}
.literalblock+.colist,.listingblock+.colist{margin-top:-.5em}
.colist>table tr>td:first-of-type{padding:.4em .75em 0 .75em;line-height:1;vertical-align:top}
.colist>table tr>td:first-of-type img{max-width:initial}
.colist>table tr>td:last-of-type{padding:.25em 0}
.thumb,.th{line-height:0;display:inline-block;border:solid 4px #fff;-webkit-box-shadow:0 0 0 1px #ddd;box-shadow:0 0 0 1px #ddd}
.imageblock.left,.imageblock[style*="float: left"]{margin:.25em .625em 1.25em 0}
.imageblock.right,.imageblock[style*="float: right"]{margin:.25em 0 1.25em .625em}
.imageblock>.title{margin-bottom:0}
.imageblock.thumb,.imageblock.th{border-width:6px}
.imageblock.thumb>.title,.imageblock.th>.title{padding:0 .125em}
.image.left,.image.right{margin-top:.25em;margin-bottom:.25em;display:inline-block;line-height:0}
.image.left{margin-right:.625em}
.image.right{margin-left:.625em}
a.image{text-decoration:none;display:inline-block}
a.image object{pointer-events:none}
sup.footnote,sup.footnoteref{font-size:.875em;position:static;vertical-align:super}
sup.footnote a,sup.footnoteref a{text-decoration:none}
sup.footnote a:active,sup.footnoteref a:active{text-decoration:underline}
#footnotes{padding-top:.75em;padding-bottom:.75em;margin-bottom:.625em}
#footnotes hr{width:20%;min-width:6.25em;margin:-.25em 0 .75em 0;border-width:1px 0 0 0}
#footnotes .footnote{padding:0 .375em 0 .225em;line-height:1.3334;font-size:.875em;margin-left:1.2em;text-indent:-1.05em;margin-bottom:.2em}
#footnotes .footnote a:first-of-type{font-weight:bold;text-decoration:none}
#footnotes .footnote:last-of-type{margin-bottom:0}
#content #footnotes{margin-top:-.625em;margin-bottom:0;padding:.75em 0}
.gist .file-data>table{border:0;background:#fff;width:100%;margin-bottom:0}
.gist .file-data>table td.line-data{width:99%}
div.unbreakable{page-break-inside:avoid}
.big{font-size:larger}
.small{font-size:smaller}
.underline{text-decoration:underline}
.overline{text-decoration:overline}
.line-through{text-decoration:line-through}
.aqua{color:#00bfbf}
.aqua-background{background-color:#00fafa}
.black{color:#000}
.black-background{background-color:#000}
.blue{color:#0000bf}
.blue-background{background-color:#0000fa}
.fuchsia{color:#bf00bf}
.fuchsia-background{background-color:#fa00fa}
.gray{color:#606060}
.gray-background{background-color:#7d7d7d}
.green{color:#006000}
.green-background{background-color:#007d00}
.lime{color:#00bf00}
.lime-background{background-color:#00fa00}
.maroon{color:#600000}
.maroon-background{background-color:#7d0000}
.navy{color:#000060}
.navy-background{background-color:#00007d}
.olive{color:#606000}
.olive-background{background-color:#7d7d00}
.purple{color:#600060}
.purple-background{background-color:#7d007d}
.red{color:#bf0000}
.red-background{background-color:#fa0000}
.silver{color:#909090}
.silver-background{background-color:#bcbcbc}
.teal{color:#006060}
.teal-background{background-color:#007d7d}
.white{color:#bfbfbf}
.white-background{background-color:#fafafa}
.yellow{color:#bfbf00}
.yellow-background{background-color:#fafa00}
span.icon>.fa{cursor:default}
a span.icon>.fa{cursor:inherit}
.admonitionblock td.icon [class^="fa icon-"]{font-size:2.5em;text-shadow:1px 1px 2px rgba(0,0,0,.5);cursor:default}
.admonitionblock td.icon .icon-note:before{content:"\f05a";color:#19407c}
.admonitionblock td.icon .icon-tip:before{content:"\f0eb";text-shadow:1px 1px 2px rgba(155,155,0,.8);color:#111}
.admonitionblock td.icon .icon-warning:before{content:"\f071";color:#bf6900}
.admonitionblock td.icon .icon-caution:before{content:"\f06d";color:#bf3400}
.admonitionblock td.icon .icon-important:before{content:"\f06a";color:#bf0000}
.conum[data-value]{display:inline-block;color:#fff!important;background-color:rgba(0,0,0,.8);-webkit-border-radius:100px;border-radius:100px;text-align:center;font-size:.75em;width:1.67em;height:1.67em;line-height:1.67em;font-family:"Open Sans","DejaVu Sans",sans-serif;font-style:normal;font-weight:bold}
.conum[data-value] *{color:#fff!important}
.conum[data-value]+b{display:none}
.conum[data-value]:after{content:attr(data-value)}
pre .conum[data-value]{position:relative;top:-.125em}
b.conum *{color:inherit!important}
.conum:not([data-value]):empty{display:none}
dt,th.tableblock,td.content,div.footnote{text-rendering:optimizeLegibility}
h1,h2,p,td.content,span.alt{letter-spacing:-.01em}
p strong,td.content strong,div.footnote strong{letter-spacing:-.005em}
p,blockquote,dt,td.content,span.alt{font-size:1.0625rem}
p{margin-bottom:1.25rem}
.sidebarblock p,.sidebarblock dt,.sidebarblock td.content,p.tableblock{font-size:1em}
.exampleblock>.content{background-color:#fffef7;border-color:#e0e0dc;-webkit-box-shadow:0 1px 4px #e0e0dc;box-shadow:0 1px 4px #e0e0dc}
.print-only{display:none!important}
@media print{@page{margin:1.25cm .75cm}
*{-webkit-box-shadow:none!important;box-shadow:none!important;text-shadow:none!important}
a{color:inherit!important;text-decoration:underline!important}
a.bare,a[href^="#"],a[href^="mailto:"]{text-decoration:none!important}
a[href^="http:"]:not(.bare):after,a[href^="https:"]:not(.bare):after{content:"(" attr(href) ")";display:inline-block;font-size:.875em;padding-left:.25em}
abbr[title]:after{content:" (" attr(title) ")"}
pre,blockquote,tr,img,object,svg{page-break-inside:avoid}
thead{display:table-header-group}
svg{max-width:100%}
p,blockquote,dt,td.content{font-size:1em;orphans:3;widows:3}
h2,h3,#toctitle,.sidebarblock>.content>.title{page-break-after:avoid}
#toc,.sidebarblock,.exampleblock>.content{background:none!important}
#toc{border-bottom:1px solid #ddddd8!important;padding-bottom:0!important}
.sect1{padding-bottom:0!important}
.sect1+.sect1{border:0!important}
#header>h1:first-child{margin-top:1.25rem}
body.book #header{text-align:center}
body.book #header>h1:first-child{border:0!important;margin:2.5em 0 1em 0}
body.book #header .details{border:0!important;display:block;padding:0!important}
body.book #header .details span:first-child{margin-left:0!important}
body.book #header .details br{display:block}
body.book #header .details br+span:before{content:none!important}
body.book #toc{border:0!important;text-align:left!important;padding:0!important;margin:0!important}
body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-break-before:always}
.listingblock code[data-lang]:before{display:block}
#footer{background:none!important;padding:0 .9375em}
#footer-text{color:rgba(0,0,0,.6)!important;font-size:.9em}
.hide-on-print{display:none!important}
.print-only{display:block!important}
.hide-for-print{display:none!important}
.show-for-print{display:inherit!important}}
</style>
</head>
<body class="article">
<div id="header">
<h1>IceWM Manual</h1>
<div class="details">
<span id="author" class="author">Marko Macek</span><br>
<span id="email" class="email"><a href="mailto:Marko.Macek@gmx.net">Marko.Macek@gmx.net</a></span><br>
<span id="revnumber">version 1.4.2,</span>
<span id="revdate">2017 November 18</span>
</div>
<div id="toc" class="toc">
<div id="toctitle">Table of Contents</div>
<ul class="sectlevel1">
<li><a href="#introduction">Introduction</a></li>
<li><a href="#copying">Copying</a></li>
<li><a href="#first-steps">First steps</a>
<ul class="sectlevel2">
<li><a href="#icewm-components">IceWM components</a></li>
<li><a href="#starting-icewm">Starting icewm</a></li>
<li><a href="#startup-and-shutdown-scripts">Startup and shutdown scripts</a></li>
<li><a href="#extra-session-environment">Extra session environment</a></li>
</ul>
</li>
<li><a href="#focus-models">Focus models</a></li>
<li><a href="#mouse-commands">Mouse Commands</a>
<ul class="sectlevel2">
<li><a href="#frame-commands">Frame Commands</a></li>
<li><a href="#title-bar-commands">Title Bar Commands</a></li>
<li><a href="#taskbar-commands">Taskbar commands</a></li>
</ul>
</li>
<li><a href="#keyboard-commands">Keyboard Commands</a></li>
<li><a href="#the-resource-path">The Resource Path</a></li>
<li><a href="#configuration-files">Configuration Files</a></li>
<li><a href="#theme">Theme</a></li>
<li><a href="#preferences">Preferences</a>
<ul class="sectlevel2">
<li><a href="#focus-and-behavior">Focus and Behavior</a></li>
<li><a href="#task-bar">Task Bar</a></li>
<li><a href="#mailbox-monitoring-updated-2018-03-04">Mailbox Monitoring (updated 2018-03-04)</a></li>
<li><a href="#menus">Menus</a></li>
<li><a href="#timings">Timings</a></li>
<li><a href="#buttons-and-keys">Buttons and Keys</a></li>
<li><a href="#workspaces">Workspaces</a></li>
<li><a href="#paths">Paths</a></li>
<li><a href="#programs">Programs</a></li>
<li><a href="#window-menus">Window Menus</a></li>
</ul>
</li>
<li><a href="#theme-settings">Theme Settings</a>
<ul class="sectlevel2">
<li><a href="#borders">Borders</a></li>
<li><a href="#fonts">Fonts</a></li>
<li><a href="#colors">Colors</a></li>
<li><a href="#desktop-background">Desktop Background</a></li>
<li><a href="#task-bar-2">Task Bar</a></li>
</ul>
</li>
<li><a href="#menus-and-toolbar-updated-2018-05-06">Menus and Toolbar (updated 2018-05-06)</a>
<ul class="sectlevel2">
<li><a href="#menu">menu</a></li>
<li><a href="#toolbar">toolbar</a></li>
<li><a href="#programs-2">programs</a></li>
</ul>
</li>
<li><a href="#hot-keys">Hot Keys</a></li>
<li><a href="#window-options-updated-2018-03-04">Window Options (updated 2018-03-04)</a></li>
<li><a href="#icon-handling">Icon handling</a>
<ul class="sectlevel2">
<li><a href="#generic">Generic</a></li>
<li><a href="#gdk-pixbuf">GDK-Pixbuf</a></li>
</ul>
</li>
<li><a href="#mouse-cursors">Mouse cursors</a></li>
<li><a href="#themes">Themes</a></li>
<li><a href="#command-line-options">Command Line Options</a></li>
<li><a href="#glossary">Glossary</a></li>
<li><a href="#authors">Authors</a></li>
<li><a href="#see-also">See Also</a></li>
</ul>
</div>
</div>
<div id="content">
<div class="sect1">
<h2 id="introduction">Introduction</h2>
<div class="sectionbody">
<div class="paragraph">
<p>This document is the manual for the <strong>IceWM</strong> X11 window manager.
The IceWM manpages provide additional documentation.</p>
</div>
<div class="paragraph">
<p>The goal of IceWM is to provide a small, fast and familiar window
manager for the X11 window system, which is compatible with the
EWMH and ICCCM window manager protocols. Generally, it tries to make
all functions available both by keyboard and by mouse (this is not
currently possible when using mouse focus).</p>
</div>
<div class="paragraph">
<p>IceWM originally was designed to emulate the look of Motif, OS/2
Warp 4, OS/2 Warp 3 and Windows 95. Since it has a theming engine
others styles are possible. A large number of original themes have
been created and <a href="https://themes.ice-wm.org">published by users</a>.</p>
</div>
<div class="paragraph">
<p>Further information can be found at <a href="https://ice-wm.org">the IceWM
website</a>,
at the <a href="https://github.com/bbidulock/icewm/">current site of
development</a>,
which includes the <a href="https://github.com/bbidulock/icewm/issues/">support
requests</a>.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="copying">Copying</h2>
<div class="sectionbody">
<div class="paragraph">
<p>IceWM and its documentation are covered by a GNU LGPL license,
which is included in the distribution.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="first-steps">First steps</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="icewm-components">IceWM components</h3>
<div class="paragraph">
<p>The IceWM suite consists of the following core applications provided
by the main package:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong><a href="https://ice-wm.org/man/icewm.html">icewm</a></strong> - The actual window
manager binary. It handles window placement and draws the window
decorations.</p>
</li>
<li>
<p><strong><a href="https://ice-wm.org/man/icewmbg.html">icewmbg</a></strong> - The background
setting application. It can assign plain background color or images in
different formats to the X background. Either shared or separate for
different workspaces. This program should be started before <code>icewm</code>.</p>
</li>
<li>
<p><strong><a href="https://ice-wm.org/man/icewm-session.html">icewm-session</a></strong> - The
IceWM session manager runs all of the above. This is the preferred
program to start IceWM.</p>
</li>
<li>
<p><strong><a href="https://ice-wm.org/man/icewm-menu-fdo.html">icewm-menu-fdo</a></strong> -
This generates IceWM program menus from FreeDesktop <code>.desktop</code> files.</p>
</li>
<li>
<p><strong><a href="https://ice-wm.org/man/icewmhint.html">icewmhint</a></strong> - Is a simple
utility for passing IceWM hints to IceWM by window class and
instance. Icewmhint uses a special property, '"_ICEWM_WINOPHINT"',
on the root window to pass special hints to IceWM.</p>
</li>
<li>
<p><strong><a href="https://ice-wm.org/man/icehelp.html">icehelp</a></strong> - Is used by icewm
to display the 'IceWM manual' and the manpages. See the output of
<code>icehelp --help</code> for details.</p>
</li>
<li>
<p><strong><a href="https://ice-wm.org/man/icesh.html">icesh</a></strong> - Could be used to manage
IceWM internals from the command line.</p>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="starting-icewm">Starting icewm</h3>
<div class="paragraph">
<p>The <code>icewm</code> program alone is suitable for use with desktop environments
like GNOME. If you wish to run the whole IceWM suite (WM, background
changer, Docklet support, and startup/shutdown script handling), use
the <code>icewm-session</code> binary instead of pure <code>icewm</code>. Note that this
is not a complete Session Manager but it helps to automate the startup.</p>
</div>
<div class="paragraph">
<p>First make sure that you choose the correct
<a href="https://www.tldp.org/HOWTO/XWindow-User-HOWTO/runningx.html">X startup</a>
script in your home directory. For most distributions either the
file <code>$HOME/.xsession</code> or <code>$HOME/.xinitrc</code> is honored by startx and
X display managers like KDM. On RedHat, the <code>$HOME/.Xclients</code> may
be used instead. In all cases, choose the one recommended by your
distribution and make sure that there is no concurrency between the
X startup scripts. Ensure that the script is executable. Mine looks
something like this:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>#!/bin/bash
# run profile to set $PATH and other env vars correctly
. $HOME/.bash_profile
# setup touchpad and the external mouse
xset m 7 2
xinput set-ptr-feedback 0 7 1.9 1

# start icewm-session
exec icewm-session
xterm</pre>
</div>
</div>
<div class="paragraph">
<p>The xterm on the last line is there simply to make sure that your X
session doesn&#8217;t crash if IceWM does (should never happen). You can
restart IceWM from there or start some other window manager. The
session will close if you close the xterm.</p>
</div>
</div>
<div class="sect2">
<h3 id="startup-and-shutdown-scripts">Startup and shutdown scripts</h3>
<div class="paragraph">
<p>After initialization <code>icewm-session</code> will search the resource
path for a <code>startup</code> script. If this file is found and if it is
executable <code>icewm-session</code> will run this script. During termination of
<code>icewm-session</code> the <code>shutdown</code> script is executed.</p>
</div>
<div class="paragraph">
<p>Example <code>~/.icewm/startup</code> script:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>#!/bin/bash

[ -x ~/.icewm/restart ] &amp;&amp; source ~/.icewm/restart

gnome-terminal --geometry 80x25+217+235 &amp;
xscreensaver &amp;</pre>
</div>
</div>
<div class="paragraph">
<p>On termination the <code>shutdown</code> script will be run first, then
<code>icewm-session</code> will terminate icewm and icewmbg.</p>
</div>
<div class="admonitionblock tip">
<table>
<tr>
<td class="icon">
<div class="title">Tip</div>
</td>
<td class="content">
<code>icewm-session</code> is meant for easy desktop initialization and it
is part of IceWM due to popular demand. For more sophisticated session
management one could use a real session manager. IceWM supports the
XSESSION protocol.
</td>
</tr>
</table>
</div>
</div>
<div class="sect2">
<h3 id="extra-session-environment">Extra session environment</h3>
<div class="paragraph">
<p>Please note that if icewm-session is used as the only startup mechanism
(without having .xsession involved), one can write additional
environment settings into the file <code>$HOME/.icewm/env</code>. Expansion
of simple shell style variables should be supported on most
platforms. Shell command expansion is supported if <code>wordexp</code> was
configured. This extra environment is only effective in applications
started by icewm-session and their subprocesses.</p>
</div>
<div class="paragraph">
<p>Example <code>env</code>:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>PATH=~/bin:$PATH
LANG=de_DE.UTF-8</pre>
</div>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="focus-models">Focus models</h2>
<div class="sectionbody">
<div class="paragraph">
<p>IceWM implements four general focus models:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong>clickToRaise</strong></p>
<div class="paragraph">
<p>Exactly like Win95, OS/2 Warp. When window is clicked with a mouse,
it is raised and activated.</p>
</div>
</li>
<li>
<p><strong>clickToFocus</strong></p>
<div class="paragraph">
<p>Window is raised and focused when titlebar or frame border is
clicked. Window is focused but not raised when window interior
is clicked.</p>
</div>
</li>
<li>
<p><strong>pointerFocus</strong></p>
<div class="paragraph">
<p>When the mouse is moved, focus is set to window under a mouse. It
should be possible to change focus with the keyboard when mouse is
not moved.</p>
</div>
</li>
<li>
<p><strong>explicitFocus</strong></p>
<div class="paragraph">
<p>When a window is clicked, it is activated, but not raised. New windows
do not automatically get the focus unless they are transient windows
for the active window.</p>
</div>
</li>
</ul>
</div>
<div class="paragraph">
<p>Detailed configuration is possible using the configuration file
options.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="mouse-commands">Mouse Commands</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="frame-commands">Frame Commands</h3>
<div class="ulist">
<ul>
<li>
<p><strong>Left Button</strong></p>
<div class="paragraph">
<p>Select and raise the window. On the window frame, resize the window.</p>
</div>
</li>
<li>
<p><strong>Right Button</strong></p>
<div class="paragraph">
<p>When dragged, moves the window. When clicked, displays the context
menu.</p>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="title-bar-commands">Title Bar Commands</h3>
<div class="ulist">
<ul>
<li>
<p><strong>Any Button Drag</strong></p>
<div class="paragraph">
<p>Move the window.</p>
</div>
</li>
<li>
<p><strong>Alt + Left Button</strong></p>
<div class="paragraph">
<p>Lower the window.</p>
</div>
</li>
<li>
<p><strong>Left Button Double Click</strong></p>
<div class="paragraph">
<p>Maximize/Restore the window.</p>
</div>
</li>
<li>
<p><strong>Middle Button Double Click</strong></p>
<div class="paragraph">
<p>Rollup/Unroll the window.</p>
</div>
</li>
</ul>
</div>
<div class="paragraph">
<p>The Ctrl key can be used together with a mouse button to prevent a
window from being raised to the top of the stack.</p>
</div>
</div>
<div class="sect2">
<h3 id="taskbar-commands">Taskbar commands</h3>
<div class="ulist">
<ul>
<li>
<p><strong>Left Button Click</strong></p>
<div class="paragraph">
<p>Activate the workspace with the window and raise the window. Toggles
the minimized/active state of the window.</p>
</div>
</li>
<li>
<p><strong>Shift + Left Button Click</strong></p>
<div class="paragraph">
<p>Move window to current workspace. This only works when windows from
all workspaces are shown on the taskbar all the time.</p>
</div>
</li>
<li>
<p><strong>Control + Left Button Click</strong></p>
<div class="paragraph">
<p>Minimize/restore the window.</p>
</div>
</li>
<li>
<p><strong>Middle Button Click</strong></p>
<div class="paragraph">
<p>Toggle raised/lowered state of the window.</p>
</div>
</li>
<li>
<p><strong>Shift + Middle Button Click</strong></p>
<div class="paragraph">
<p>Add the window to the current workspace.</p>
</div>
</li>
<li>
<p><strong>Control + Middle Button Click</strong></p>
<div class="paragraph">
<p>Lower the window.</p>
</div>
</li>
<li>
<p><strong>Right Button Click</strong></p>
<div class="paragraph">
<p>Display a context menu.</p>
</div>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="keyboard-commands">Keyboard Commands</h2>
<div class="sectionbody">
<div class="paragraph">
<p>The Alt key is assumed to be the key defined as the Mod1 modifier.</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>Alt+F1</code></p>
<div class="paragraph">
<p>Raise the window.</p>
</div>
</li>
<li>
<p><code>Alt+F2</code></p>
<div class="paragraph">
<p>Make a window occupy all desktops.</p>
</div>
</li>
<li>
<p><code>Alt+F3</code></p>
<div class="paragraph">
<p>Lower the window to the bottom of the stack.</p>
</div>
</li>
<li>
<p><code>Alt+F4</code></p>
<div class="paragraph">
<p>Close the window.</p>
</div>
</li>
<li>
<p><code>Alt+F5</code></p>
<div class="paragraph">
<p>Restore the window state if maximized or minimized/hidden.</p>
</div>
</li>
<li>
<p><code>Alt+F6</code></p>
<div class="paragraph">
<p>Focus to next window.</p>
</div>
</li>
<li>
<p><code>Alt+Shift+F6</code></p>
<div class="paragraph">
<p>Focus to previous window.</p>
</div>
</li>
<li>
<p><code>Alt+F7</code></p>
<div class="paragraph">
<p>Starts movement of the active window. Move the window either by the
mouse or by the arrow keys. The arrow keys can be accelerated four
times by the Shift key or sixteen times by the Control key. Press
the left button or the Enter key when done. To cancel press Escape.</p>
</div>
</li>
<li>
<p><code>Alt+F8</code></p>
<div class="paragraph">
<p>Starts resizing of the active window. Resize the window either by the
mouse or by the arrow keys. The arrow keys can be accelerated four
times by the Shift key or sixteen times by the Control key. Press
the left button or the Enter key when done. To cancel press Escape.</p>
</div>
</li>
<li>
<p><code>Alt+F9</code></p>
<div class="paragraph">
<p>Minimize the window to taskbar.</p>
</div>
</li>
<li>
<p><code>Alt+F10</code></p>
<div class="paragraph">
<p>Maximize the window.</p>
</div>
</li>
<li>
<p><code>Alt+Shift+F10</code></p>
<div class="paragraph">
<p>Maximize the window vertically (toggle).</p>
</div>
</li>
<li>
<p><code>Alt+F11</code></p>
<div class="paragraph">
<p>Hide the window (appears in window list, but not on taskbar).</p>
</div>
</li>
<li>
<p><code>Alt+F12</code></p>
<div class="paragraph">
<p>Rollup the window.</p>
</div>
</li>
<li>
<p><code>Ctrl+Escape</code></p>
<div class="paragraph">
<p>Show the start menu.</p>
</div>
</li>
<li>
<p><code>Ctrl+Alt+Escape</code></p>
<div class="paragraph">
<p>Show the window list.</p>
</div>
</li>
<li>
<p><code>Shift+Escape</code></p>
<div class="paragraph">
<p>Show the system-menu of the window.</p>
</div>
</li>
<li>
<p><code>Alt+Escape</code></p>
<div class="paragraph">
<p>Focus to next window (down in zorder)</p>
</div>
</li>
<li>
<p><code>Alt+Shift+Escape</code></p>
<div class="paragraph">
<p>Focus to previous window (up in zorder)</p>
</div>
</li>
<li>
<p><code>Alt+Tab</code></p>
<div class="paragraph">
<p>Switch between windows (top -&gt; bottom).</p>
</div>
</li>
<li>
<p><code>Alt+Shift+Tab</code></p>
<div class="paragraph">
<p>Switch between windows (bottom &lt;- top).</p>
</div>
</li>
<li>
<p><code>Ctrl+Alt+LeftArrow</code></p>
<div class="paragraph">
<p>Switch to the previous workspace (cycle).</p>
</div>
</li>
<li>
<p><code>Ctrl+Alt+RightArrow</code></p>
<div class="paragraph">
<p>Switch to the next workspace (cycle).</p>
</div>
</li>
<li>
<p><code>Ctrl+Alt+DownArrow</code></p>
<div class="paragraph">
<p>Switch to the previously active workspace.</p>
</div>
</li>
<li>
<p><code>Ctrl+Alt+Shift+LeftArrow</code></p>
<div class="paragraph">
<p>Move the focused window to the previous workspace and activate it.</p>
</div>
</li>
<li>
<p><code>Ctrl+Alt+Shift+RightArrow</code></p>
<div class="paragraph">
<p>Move the focused window to the next workspace and activate it.</p>
</div>
</li>
<li>
<p><code>Ctrl+Alt+Shift+DownArrow</code></p>
<div class="paragraph">
<p>Move the focused window to the previously active workspace and
activate it.</p>
</div>
</li>
<li>
<p><code>Ctrl+Alt+Delete</code></p>
<div class="paragraph">
<p>displays the session dialog.</p>
</div>
</li>
<li>
<p><code>Ctrl+Alt+Space</code></p>
<div class="paragraph">
<p>Activate the AddressBar. This is a command line in the taskbar where a
shell command can be typed. Pressing the Enter key will execute the
command. If <strong>AddressBarCommand</strong> was configured it will be used to
execute the command otherwise <code>/bin/sh</code> is used. If the <strong>Control</strong>
key was also pressed then the command is executed in a terminal
as given by <strong>TerminalCommand</strong>. The address bar maintains a history
which is navigable by the Up and Down keys. A rich set of editing
operations is supported, including cut-/copy-/paste-operations and
file completion using <strong>Tab</strong> or <strong>Ctrl-I</strong>.</p>
</div>
</li>
</ul>
</div>
</div>
</div>
<div class="sect1">
<h2 id="the-resource-path">The Resource Path</h2>
<div class="sectionbody">
<div class="paragraph">
<p>IceWM looks in several locations for configuration information,
themes and customization; together these locations are called the
resource path. The resource path contains the following directories:</p>
</div>
<div class="paragraph">
<p>$ICEWM_PRIVCFG; $XDG_CONFIG_HOME/icewm; $HOME/.icewm
The first of these which is defined and existent is used to search
for the user&#8217;s personal customization.</p>
</div>
<div class="paragraph">
<p>/etc/icewm
the system-wide defaults directory</p>
</div>
<div class="paragraph">
<p>/usr/share/icewm OR /usr/local/share/icewm
the compiled-in default directory with default files</p>
</div>
<div class="paragraph">
<p>The directories are searched in the above order, so any file located
in the system/install directory can be overridden by the user by
creating the same directory hierarchy under <code>$HOME/.icewm</code>.</p>
</div>
<div class="paragraph">
<p>To customize icewm yourself, you could create the <code>$HOME/.icewm</code>
directory and copy the files that you wish to modify, like
<code>preferences</code>, <code>keys</code> or <code>winoptions</code>, from <code>/etc/icewm</code>,
<code>/usr/share/icewm</code> or <code>/usr/local/share/icewm</code> and then modify as
you like.</p>
</div>
<div class="paragraph">
<p>To customize the default themes, create the <code>$HOME/.icewm/themes</code>
directory and copy all the theme files there and then modify as
necessary. Each theme has its own subdirectory. Themes can be
downloaded from <a href="https://themes.ice-wm.org" class="bare">https://themes.ice-wm.org</a>.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="configuration-files">Configuration Files</h2>
<div class="sectionbody">
<div class="paragraph">
<p>IceWM uses the following configuration files:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong><a href="https://ice-wm.org/man/icewm-theme.html">theme</a></strong></p>
<div class="paragraph">
<p>Currently selected theme</p>
</div>
</li>
<li>
<p><strong><a href="https://ice-wm.org/man/icewm-preferences.html">preferences</a></strong></p>
<div class="paragraph">
<p>General settings - paths, colors, fonts&#8230;&#8203;</p>
</div>
</li>
<li>
<p><strong><a href="https://ice-wm.org/man/icewm-prefoverride.html">prefoverride</a></strong></p>
<div class="paragraph">
<p>Settings that should override the themes.</p>
</div>
</li>
<li>
<p><strong><a href="https://ice-wm.org/man/icewm-menu.html">menu</a></strong></p>
<div class="paragraph">
<p>Menu of startable applications. Usually customized by the user.</p>
</div>
</li>
<li>
<p><strong><a href="https://ice-wm.org/man/icewm-programs.html">programs</a></strong></p>
<div class="paragraph">
<p>Automatically generated menu of startable applications (this should
be used for <strong>wmconfig</strong>, <strong>menu</strong> or similar packages, perhaps as a part
of the login or X startup sequence).</p>
</div>
</li>
<li>
<p><strong><a href="https://ice-wm.org/man/icewm-winoptions.html">winoptions</a></strong></p>
<div class="paragraph">
<p>Application window options</p>
</div>
</li>
<li>
<p><strong><a href="https://ice-wm.org/man/icewm-keys.html">keys</a></strong></p>
<div class="paragraph">
<p>Global keybindings to launch applications (not window manager related)</p>
</div>
</li>
<li>
<p><strong><a href="https://ice-wm.org/man/icewm-toolbar.html">toolbar</a></strong></p>
<div class="paragraph">
<p>Quick launch application icons on the taskbar.</p>
</div>
</li>
</ul>
</div>
</div>
</div>
<div class="sect1">
<h2 id="theme">Theme</h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <code>theme</code> file contains the currently selected theme. It will be
overwritten automatically when a theme is selected from the Themes
menu.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="preferences">Preferences</h2>
<div class="sectionbody">
<div class="paragraph">
<p>This section shows preferences that can be set in <code>preferences</code>. Themes
will not be able to override these settings. Default values are shown
following the equal sign.</p>
</div>
<div class="sect2">
<h3 id="focus-and-behavior">Focus and Behavior</h3>
<div class="paragraph">
<p>The following settings can be set to value 1 (enabled) or value 0
(disabled).</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>ClickToFocus = 1</code></p>
<div class="paragraph">
<p>Enables click to focus mode.</p>
</div>
</li>
<li>
<p><code>RaiseOnFocus = 1</code></p>
<div class="paragraph">
<p>Window is raised when focused.</p>
</div>
</li>
<li>
<p><code>FocusOnClickClient = 1</code></p>
<div class="paragraph">
<p>Window is focused when client area is clicked.</p>
</div>
</li>
<li>
<p><code>RaiseOnClickClient = 1</code></p>
<div class="paragraph">
<p>Window is raised when client area is clicked.</p>
</div>
</li>
<li>
<p><code>RaiseOnClickTitleBar = 1</code></p>
<div class="paragraph">
<p>Window is raised when titlebar is clicked.</p>
</div>
</li>
<li>
<p><code>RaiseOnClickButton = 1</code></p>
<div class="paragraph">
<p>Window is raised when title bar button is clicked.</p>
</div>
</li>
<li>
<p><code>RaiseOnClickFrame = 1</code></p>
<div class="paragraph">
<p>Window is raised when frame is clicked.</p>
</div>
</li>
<li>
<p><code>LowerOnClickWhenRaised = 0</code></p>
<div class="paragraph">
<p>Lower the active window when clicked again.</p>
</div>
</li>
<li>
<p><code>PassFirstClickToClient = 1</code></p>
<div class="paragraph">
<p>The click which raises the window is also passed to the client.</p>
</div>
</li>
<li>
<p><code>FocusChangesWorkspace = 0</code></p>
<div class="paragraph">
<p>Change to the workspace of newly focused windows.</p>
</div>
</li>
<li>
<p><code>AutoRaise = 0</code></p>
<div class="paragraph">
<p>Windows will raise automatically after AutoRaiseDelay when focused.</p>
</div>
</li>
<li>
<p><code>StrongPointerFocus = 0</code></p>
<div class="paragraph">
<p>When focus follows mouse always give the focus to the window under
mouse pointer - Even when no mouse motion has occured. Using this is
not recommended. Please prefer to use just ClickToFocus=0.</p>
</div>
</li>
<li>
<p><code>FocusOnMap = 1</code></p>
<div class="paragraph">
<p>Window is focused after being mapped.</p>
</div>
</li>
<li>
<p><code>FocusOnMapTransient = 1</code></p>
<div class="paragraph">
<p>Transient window is focused after being mapped.</p>
</div>
</li>
<li>
<p><code>FocusOnMapTransientActive = 1</code></p>
<div class="paragraph">
<p>Focus dialog window when initially mapped only if parent frame focused.</p>
</div>
</li>
<li>
<p><code>FocusOnAppRaise = 1</code></p>
<div class="paragraph">
<p>The window is focused when application raises it.</p>
</div>
</li>
<li>
<p><code>RequestFocusOnAppRaise = 1</code></p>
<div class="paragraph">
<p>Request focus (flashing in taskbar) when application requests raise.</p>
</div>
</li>
<li>
<p><code>MapInactiveOnTop = 1</code></p>
<div class="paragraph">
<p>Put new windows on top even if not focusing them.</p>
</div>
</li>
<li>
<p><code>PointerColormap = 0</code></p>
<div class="paragraph">
<p>Colormap focus follows pointer.</p>
</div>
</li>
<li>
<p><code>DontRotateMenuPointer = 1</code></p>
<div class="paragraph">
<p>Don&#8217;t rotate the cursor for popup menus.</p>
</div>
</li>
<li>
<p><code>LimitSize = 1</code></p>
<div class="paragraph">
<p>Limit size of windows to screen.</p>
</div>
</li>
<li>
<p><code>LimitPosition = 1</code></p>
<div class="paragraph">
<p>Limit position of windows to screen.</p>
</div>
</li>
<li>
<p><code>LimitByDockLayer = 0</code></p>
<div class="paragraph">
<p>Let the Dock layer limit the workspace (incompatible with GNOME Panel).</p>
</div>
</li>
<li>
<p><code>ConsiderHBorder = 0</code></p>
<div class="paragraph">
<p>Consider border frames when maximizing horizontally.</p>
</div>
</li>
<li>
<p><code>ConsiderVBorder = 0</code></p>
<div class="paragraph">
<p>Consider border frames when maximizing vertically.</p>
</div>
</li>
<li>
<p><code>ConsiderSizeHintsMaximized = 1</code></p>
<div class="paragraph">
<p>Consider XSizeHints if frame is maximized.</p>
</div>
</li>
<li>
<p><code>CenterMaximizedWindows = 0</code></p>
<div class="paragraph">
<p>Center maximized windows which can&#8217;t fit the screen (like terminals).</p>
</div>
</li>
<li>
<p><code>HideBordersMaximized = 0</code></p>
<div class="paragraph">
<p>Hide window borders if window is maximized.</p>
</div>
</li>
<li>
<p><code>HideTitleBarWhenMaximized = 0</code></p>
<div class="paragraph">
<p>Hide title bar when maximized.</p>
</div>
</li>
<li>
<p><code>CenterLarge = 0</code></p>
<div class="paragraph">
<p>Center large windows.</p>
</div>
</li>
<li>
<p><code>CenterTransientsOnOwner = 1</code></p>
<div class="paragraph">
<p>Center dialogs on owner window.</p>
</div>
</li>
<li>
<p><code>SizeMaximized = 0</code></p>
<div class="paragraph">
<p>Window can be resized when maximized.</p>
</div>
</li>
<li>
<p><code>MinimizeToDesktop = 0</code></p>
<div class="paragraph">
<p>Window is minimized to desktop area (in addition to the taskbar).</p>
</div>
</li>
<li>
<p><code>MiniIconsPlaceHorizontal = 0</code></p>
<div class="paragraph">
<p>Place the mini-icons horizontal instead of vertical.</p>
</div>
</li>
<li>
<p><code>MiniIconsRightToLeft = 0</code></p>
<div class="paragraph">
<p>Place new mini-icons from right to left.</p>
</div>
</li>
<li>
<p><code>MiniIconsBottomToTop = 0</code></p>
<div class="paragraph">
<p>Place new mini-icons from bottom to top.</p>
</div>
</li>
<li>
<p><code>GrabRootWindow = 1</code></p>
<div class="paragraph">
<p>Manage root window (EXPERIMENTAL - normally enabled!).</p>
</div>
</li>
<li>
<p><code>ShowMoveSizeStatus = 1</code></p>
<div class="paragraph">
<p>Move/resize status window is visible when moving/resizing the window.</p>
</div>
</li>
<li>
<p><code>ShowWorkspaceStatus = 1</code></p>
<div class="paragraph">
<p>Show name of current workspace while switching.</p>
</div>
</li>
<li>
<p><code>ShowWorkspaceStatusAfterSwitch = 1</code></p>
<div class="paragraph">
<p>Show name of current workspace while switching workspaces.</p>
</div>
</li>
<li>
<p><code>ShowWorkspaceStatusAfterActivation = 1</code></p>
<div class="paragraph">
<p>Show name of current workspace after explicit activation.</p>
</div>
</li>
<li>
<p><code>WarpPointer = 0</code></p>
<div class="paragraph">
<p>Pointer is moved in pointer focus move when focus is moved using
the keyboard.</p>
</div>
</li>
<li>
<p><code>OpaqueMove = 1</code></p>
<div class="paragraph">
<p>Window is immediately moved when dragged, no outline is shown.</p>
</div>
</li>
<li>
<p><code>OpaqueResize = 0</code></p>
<div class="paragraph">
<p>Window is immediately resized when dragged, no outline is shown.</p>
</div>
</li>
<li>
<p><code>DelayPointerFocus = 1</code></p>
<div class="paragraph">
<p>Similar to delayed auto raise.</p>
</div>
</li>
<li>
<p><code>Win95Keys = 0</code></p>
<div class="paragraph">
<p>Makes 3 additional keys perform sensible functions. The keys must be
mapped to MetaL,MetaR and Menu. The left one will activate the start
menu and the right one will display the window list.</p>
</div>
</li>
<li>
<p><code>ModSuperIsCtrlAlt = 1</code></p>
<div class="paragraph">
<p>Treat Super/Win modifier as Ctrl+Alt.</p>
</div>
</li>
<li>
<p><code>UseMouseWheel = 0</code></p>
<div class="paragraph">
<p>mouse wheel support</p>
</div>
</li>
<li>
<p><code>ShowPopupsAbovePointer = 0</code></p>
<div class="paragraph">
<p>Show popup menus above mouse pointer.</p>
</div>
</li>
<li>
<p><code>ReplayMenuCancelClick = 0</code></p>
<div class="paragraph">
<p>Send the clicks outside menus to target window.</p>
</div>
</li>
<li>
<p><code>ManualPlacement = 0</code></p>
<div class="paragraph">
<p>Windows must be placed manually by the user.</p>
</div>
</li>
<li>
<p><code>SmartPlacement = 1</code></p>
<div class="paragraph">
<p>Smart window placement (minimal overlap).</p>
</div>
</li>
<li>
<p><code>IgnoreNoFocusHint = 0</code></p>
<div class="paragraph">
<p>Ignore no-accept-focus hint set by some windows.</p>
</div>
</li>
<li>
<p><code>MenuMouseTracking = 0</code></p>
<div class="paragraph">
<p>If enabled, menus will track the mouse even when no mouse button
is pressed.</p>
</div>
</li>
<li>
<p><code>ClientWindowMouseActions = 1</code></p>
<div class="paragraph">
<p>Allow mouse actions on client windows.</p>
</div>
</li>
<li>
<p><code>SnapMove = 1</code></p>
<div class="paragraph">
<p>Snap to nearest screen edge/window when moving windows.</p>
</div>
</li>
<li>
<p><code>SnapDistance = 8</code></p>
<div class="paragraph">
<p>Distance in pixels before windows snap together</p>
</div>
</li>
<li>
<p><code>ArrangeWindowsOnScreenSizeChange = 1</code></p>
<div class="paragraph">
<p>Automatically arrange windows when screen size changes.</p>
</div>
</li>
<li>
<p><code>MsgBoxDefaultAction = 0</code></p>
<div class="paragraph">
<p>Preselect to Cancel (0) or the OK (1) button in message boxes</p>
</div>
</li>
<li>
<p><code>EdgeResistance = 32</code></p>
<div class="paragraph">
<p>Resistance to move window with mouse outside screen limits. Setting
it to 10000 makes the resistance infinite.</p>
</div>
</li>
<li>
<p><code>AllowFullscreen = 1</code></p>
<div class="paragraph">
<p>Allow to switch a window to fullscreen.</p>
</div>
</li>
<li>
<p><code>FullscreenUseAllMonitors = 0</code></p>
<div class="paragraph">
<p>Span over all available screens if window goes into fullscreen.</p>
</div>
</li>
<li>
<p><code>NetWorkAreaBehaviour = 0</code></p>
<div class="paragraph">
<p>NET_WORKAREA behaviour: 0 (single/multimonitor with STRUT information,
like metacity), 1 (always full desktop), 2 (singlemonitor with STRUT,
multimonitor without STRUT).</p>
</div>
</li>
<li>
<p><code>ConfirmLogout = 1</code></p>
<div class="paragraph">
<p>Confirm Logout.</p>
</div>
</li>
<li>
<p><code>MultiByte = 1</code></p>
<div class="paragraph">
<p>Overrides automatic multiple byte detection.</p>
</div>
</li>
<li>
<p><code>ShapesProtectClientWindow = 1</code></p>
<div class="paragraph">
<p>Don&#8217;t cut client windows by shapes set trough frame corner pixmap.</p>
</div>
</li>
<li>
<p><code>DoubleBuffer = 1</code></p>
<div class="paragraph">
<p>Use double buffering when redrawing the display.</p>
</div>
</li>
<li>
<p><code>XRRDisable = 0</code></p>
<div class="paragraph">
<p>Disable use of new XRANDR API for dual head (nvidia workaround)</p>
</div>
</li>
<li>
<p><code>PreferFreetypeFonts = 1</code></p>
<div class="paragraph">
<p>Favor *Xft fonts over core X11 fonts where possible.</p>
</div>
</li>
<li>
<p><code>IconPath =
/usr/share/icons/hicolor:/usr/share/icons:/usr/share/pixmaps</code></p>
<div class="paragraph">
<p>Icon search path (colon separated)</p>
</div>
</li>
<li>
<p><code>MailCommand = xterm -name mutt -e mutt</code></p>
<div class="paragraph">
<p>Command to run on mailbox.</p>
</div>
</li>
<li>
<p><code>MailClassHint = mutt.XTerm</code></p>
<div class="paragraph">
<p>WM_CLASS to allow runonce for MailCommand.</p>
</div>
</li>
<li>
<p><code>NewMailCommand =</code>
Command to run when new mail arrives.</p>
</li>
<li>
<p><code>LockCommand =</code>
Command to lock display/screensaver.</p>
</li>
<li>
<p><code>ClockCommand = xclock -name icewm -title Clock</code></p>
<div class="paragraph">
<p>Command to run on clock.</p>
</div>
</li>
<li>
<p><code>ClockClassHint = icewm.XClock</code></p>
<div class="paragraph">
<p>WM_CLASS to allow runonce for ClockCommand.</p>
</div>
</li>
<li>
<p><code>RunCommand =</code>
Command to select and run a program.</p>
</li>
<li>
<p><code>OpenCommand =</code>
Command to run to open a file.</p>
</li>
<li>
<p><code>TerminalCommand = xterm</code></p>
</li>
</ul>
</div>
<div class="paragraph">
<p>Terminal emulator must accept -e option.</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>LogoutCommand =</code>
Command to start logout.</p>
</li>
<li>
<p><code>LogoutCancelCommand =</code>
Command to cancel logout.</p>
</li>
<li>
<p><code>ShutdownCommand =</code>
Command to shutdown the system.</p>
</li>
<li>
<p><code>RebootCommand =</code>
Command to reboot the system.</p>
</li>
<li>
<p><code>SuspendCommand =</code>
Command to send the system to standby mode.</p>
</li>
<li>
<p><code>CPUStatusCommand =</code>
Command to run on CPU status.</p>
</li>
<li>
<p><code>CPUStatusClassHint = top.XTerm</code></p>
<div class="paragraph">
<p>WM_CLASS to allow runonce for CPUStatusCommand.</p>
</div>
</li>
<li>
<p><code>CPUStatusCombine = 1</code></p>
<div class="paragraph">
<p>Combine all CPUs to one.</p>
</div>
</li>
<li>
<p><code>NetStatusCommand =</code>
Command to run on Net status.</p>
</li>
<li>
<p><code>NetStatusClassHint = netstat.XTerm</code></p>
<div class="paragraph">
<p>WM_CLASS to allow runonce for NetStatusCommand.</p>
</div>
</li>
<li>
<p><code>AddressBarCommand =</code>
Command to run for address bar entries.</p>
</li>
<li>
<p><code>XRRPrimaryScreenName =</code>
screen/output name of the primary screen.</p>
</li>
</ul>
</div>
<div class="sect3">
<h4 id="quick-switch-list">Quick Switch List</h4>
<div class="ulist">
<ul>
<li>
<p><code>QuickSwitch = 1</code></p>
<div class="paragraph">
<p>enable Alt+Tab window switcher.</p>
</div>
</li>
<li>
<p><code>QuickSwitchToMinimized = 1</code></p>
<div class="paragraph">
<p>Alt+Tab switches to minimized windows too.</p>
</div>
</li>
<li>
<p><code>QuickSwitchToHidden = 1</code></p>
<div class="paragraph">
<p>Alt+Tab to hidden windows.</p>
</div>
</li>
<li>
<p><code>QuickSwitchToUrgent = 1</code></p>
<div class="paragraph">
<p>Priorize Alt+Tab to urgent windows.</p>
</div>
</li>
<li>
<p><code>QuickSwitchToAllWorkspaces = 1</code></p>
<div class="paragraph">
<p>Alt+Tab switches to windows on any workspace.</p>
</div>
</li>
<li>
<p><code>QuickSwitchGroupWorkspaces = 1</code></p>
<div class="paragraph">
<p>Alt+Tab: group windows on current workspace.</p>
</div>
</li>
<li>
<p><code>QuickSwitchAllIcons = 1</code></p>
<div class="paragraph">
<p>Show all reachable icons when quick switching.</p>
</div>
</li>
<li>
<p><code>QuickSwitchTextFirst = 0</code></p>
<div class="paragraph">
<p>Show the window title above (all reachable) icons.</p>
</div>
</li>
<li>
<p><code>QuickSwitchSmallWindow = 0</code></p>
<div class="paragraph">
<p>Attempt to create a small QuickSwitch window (1/3 instead of 3/5 of</p>
</div>
</li>
<li>
<p><code>QuickSwitchMaxWidth = 0</code></p>
<div class="paragraph">
<p>Go through all window titles and choose width of the longest one.</p>
</div>
</li>
<li>
<p><code>QuickSwitchVertical = 1</code></p>
<div class="paragraph">
<p>Place the icons and titles vertical instead of horizontal.</p>
</div>
</li>
<li>
<p><code>QuickSwitchHugeIcon = 0</code></p>
<div class="paragraph">
<p>Show the huge (48x48) of the window icon for the active window.</p>
</div>
</li>
<li>
<p><code>QuickSwitchFillSelection = 0</code></p>
<div class="paragraph">
<p>Fill the rectangle highlighting the current icon.</p>
</div>
</li>
</ul>
</div>
</div>
<div class="sect3">
<h4 id="edge-workspace-switching">Edge Workspace Switching</h4>
<div class="ulist">
<ul>
<li>
<p><code>EdgeSwitch = 0</code></p>
<div class="paragraph">
<p>Workspace switches by moving mouse to left/right screen edge.</p>
</div>
</li>
<li>
<p><code>HorizontalEdgeSwitch = 0</code></p>
<div class="paragraph">
<p>Workspace switches by moving mouse to left/right screen edge.</p>
</div>
</li>
<li>
<p><code>VerticalEdgeSwitch = 0</code></p>
<div class="paragraph">
<p>Workspace switches by moving mouse to top/bottom screen edge.</p>
</div>
</li>
<li>
<p><code>ContinuousEdgeSwitch = 1</code></p>
<div class="paragraph">
<p>Workspace switches continuously when moving mouse to screen edge.</p>
</div>
</li>
</ul>
</div>
</div>
</div>
<div class="sect2">
<h3 id="task-bar">Task Bar</h3>
<div class="paragraph">
<p>The following settings can be set to value 1 (enabled) or value 0
(disabled).</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>ShowTaskBar = 1</code></p>
<div class="paragraph">
<p>Task bar is visible.</p>
</div>
</li>
<li>
<p><code>TaskBarAtTop = 0</code></p>
<div class="paragraph">
<p>Task bar is located at top of screen.</p>
</div>
</li>
<li>
<p><code>TaskBarKeepBelow = 1</code></p>
<div class="paragraph">
<p>Keep the task bar below regular windows</p>
</div>
</li>
<li>
<p><code>TaskBarAutoHide = 0</code></p>
<div class="paragraph">
<p>Task bar will auto hide when mouse leaves it.</p>
</div>
</li>
<li>
<p><code>TaskBarFullscreenAutoShow = 1</code></p>
<div class="paragraph">
<p>Auto show task bar when fullscreen window active.</p>
</div>
</li>
<li>
<p><code>TaskBarShowClock = 1</code></p>
<div class="paragraph">
<p>Task bar clock is visible.</p>
</div>
</li>
<li>
<p><code>TaskBarShowAPMStatus = 0</code></p>
<div class="paragraph">
<p>Show APM/ACPI/Battery/Power status monitor on task bar.</p>
</div>
</li>
<li>
<p><code>TaskBarShowAPMAuto = 1</code></p>
<div class="paragraph">
<p>Enable TaskBarShowAPMStatus if a battery is present.</p>
</div>
</li>
<li>
<p><code>TaskBarShowAPMTime = 1</code></p>
<div class="paragraph">
<p>Show APM status on task bar in time-format.</p>
</div>
</li>
<li>
<p><code>TaskBarShowAPMGraph = 1</code></p>
<div class="paragraph">
<p>Show APM status in graph mode.</p>
</div>
</li>
<li>
<p><code>TaskBarShowMailboxStatus = 1</code></p>
<div class="paragraph">
<p>Display status of mailbox (see 'Mailbox' below).</p>
</div>
</li>
<li>
<p><code>TaskBarMailboxStatusBeepOnNewMail = 0</code></p>
<div class="paragraph">
<p>Beep when new mail arrives.</p>
</div>
</li>
<li>
<p><code>TaskBarMailboxStatusCountMessages = 0</code></p>
<div class="paragraph">
<p>Display mail message count as tooltip.</p>
</div>
</li>
<li>
<p><code>TaskBarShowWorkspaces = 1</code></p>
<div class="paragraph">
<p>Show workspace switching buttons on task bar.</p>
</div>
</li>
<li>
<p><code>TaskBarShowWindows = 1</code></p>
<div class="paragraph">
<p>Show windows on the taskbar.</p>
</div>
</li>
<li>
<p><code>TaskBarShowShowDesktopButton = 1</code></p>
<div class="paragraph">
<p>Show 'show desktop' button on taskbar.</p>
</div>
</li>
<li>
<p><code>ShowEllipsis = 0</code></p>
<div class="paragraph">
<p>Show Ellipsis in taskbar items.</p>
</div>
</li>
<li>
<p><code>TaskBarShowTray = 1</code></p>
<div class="paragraph">
<p>Show windows in the tray.</p>
</div>
</li>
<li>
<p><code>TrayShowAllWindows = 1</code></p>
<div class="paragraph">
<p>Show windows from all workspaces on tray.</p>
</div>
</li>
<li>
<p><code>TaskBarEnableSystemTray = 1</code></p>
<div class="paragraph">
<p>Enable the system tray in the taskbar.</p>
</div>
</li>
<li>
<p><code>TaskBarShowTransientWindows = 1</code></p>
<div class="paragraph">
<p>Show transient (dialogs, &#8230;&#8203;) windows on task bar.</p>
</div>
</li>
<li>
<p><code>TaskBarShowAllWindows = 0</code></p>
<div class="paragraph">
<p>Show windows from all workspaces on task bar.</p>
</div>
</li>
<li>
<p><code>TaskBarShowWindowIcons = 1</code></p>
<div class="paragraph">
<p>Show icons of windows on the task bar.</p>
</div>
</li>
<li>
<p><code>TaskBarShowStartMenu = 1</code></p>
<div class="paragraph">
<p>Show button for the start menu on the task bar.</p>
</div>
</li>
<li>
<p><code>TaskBarShowWindowListMenu = 1</code></p>
<div class="paragraph">
<p>Show button for window list menu on taskbar.</p>
</div>
</li>
<li>
<p><code>TaskBarShowCPUStatus = 1</code></p>
<div class="paragraph">
<p>Show CPU status on task bar (Linux &amp; Solaris).</p>
</div>
</li>
<li>
<p><code>CPUStatusShowRamUsage = 1</code></p>
<div class="paragraph">
<p>Show RAM usage in CPU status tool tip.</p>
</div>
</li>
<li>
<p><code>CPUStatusShowSwapUsage = 1</code></p>
<div class="paragraph">
<p>Show swap usage in CPU status tool tip.</p>
</div>
</li>
<li>
<p><code>CPUStatusShowAcpiTemp = 1</code></p>
<div class="paragraph">
<p>Show ACPI temperature in CPU status tool tip.</p>
</div>
</li>
<li>
<p><code>CPUStatusShowAcpiTempInGraph = 0</code></p>
<div class="paragraph">
<p>Show ACPI temperature in CPU graph.</p>
</div>
</li>
<li>
<p><code>AcpiIgnoreBatteries =</code>
List of battery names ignore.</p>
</li>
<li>
<p><code>CPUStatusShowCpuFreq = 1</code></p>
<div class="paragraph">
<p>Show CPU frequency in CPU status tool tip.</p>
</div>
</li>
<li>
<p><code>TaskBarShowMEMStatus = 1</code></p>
<div class="paragraph">
<p>Show memory usage status on task bar (Linux only).</p>
</div>
</li>
<li>
<p><code>TaskBarShowNetStatus = 1</code></p>
<div class="paragraph">
<p>Show network status on task bar (Linux only).</p>
</div>
</li>
<li>
<p><code>NetworkStatusDevice = "[ew]*"</code>
List of network devices to be displayed in tray, space separated. Shell
wildcard patterns can also be used.</p>
</li>
<li>
<p><code>TaskBarShowCollapseButton = 0</code></p>
<div class="paragraph">
<p>Show a button to collapse the taskbar.</p>
</div>
</li>
<li>
<p><code>TaskBarDoubleHeight = 0</code></p>
<div class="paragraph">
<p>Double height task bar</p>
</div>
</li>
<li>
<p><code>TaskBarWorkspacesLeft = 1</code></p>
<div class="paragraph">
<p>Place workspace pager on left, not right.</p>
</div>
</li>
<li>
<p><code>TaskBarWorkspacesTop = 0</code></p>
<div class="paragraph">
<p>Place workspace pager on top row when using dual-height taskbar.</p>
</div>
</li>
<li>
<p><code>PagerShowPreview = 1</code></p>
<div class="paragraph">
<p>Show a mini desktop preview on each workspace button. By pressing
the middle mouse button the 'window list' is shown. The right button
activates the 'window list menu'. By using the scroll wheel over the
'workspace list' one can quickly cycle over all workspaces.</p>
</div>
</li>
<li>
<p><code>PagerShowWindowIcons = 1</code></p>
<div class="paragraph">
<p>Draw window icons inside large enough preview windows on pager
(if PagerShowPreview=1).</p>
</div>
</li>
<li>
<p><code>PagerShowMinimized = 1</code></p>
<div class="paragraph">
<p>Draw even minimized windows as unfilled rectangles (if
PagerShowPreview=1).</p>
</div>
</li>
<li>
<p><code>PagerShowBorders = 1</code></p>
<div class="paragraph">
<p>Draw border around workspace buttons (if PagerShowPreview=1).</p>
</div>
</li>
<li>
<p><code>PagerShowNumbers = 1</code></p>
<div class="paragraph">
<p>Show number of workspace on workspace button (if PagerShowPreview=1).</p>
</div>
</li>
<li>
<p><code>TaskBarLaunchOnSingleClick = 1</code></p>
<div class="paragraph">
<p>Execute taskbar applet commands (like MailCommand, ClockCommand,
&#8230;&#8203;) on single click.</p>
</div>
</li>
<li>
<p><code>EnableAddressBar = 1</code></p>
<div class="paragraph">
<p>Enable address bar functionality in taskbar.</p>
</div>
</li>
<li>
<p><code>ShowAddressBar = 1</code></p>
<div class="paragraph">
<p>Show address bar in task bar.</p>
</div>
</li>
<li>
<p><code>TimeFormat = "%X"</code></p>
<div class="paragraph">
<p>format for the taskbar clock (time) (see strftime(3) manpage).</p>
</div>
</li>
<li>
<p><code>TimeFormatAlt = ""</code></p>
<div class="paragraph">
<p>Alternate Clock Time format (e.g. for blinking effects).</p>
</div>
</li>
<li>
<p><code>DateFormat = "%c"</code></p>
<div class="paragraph">
<p>format for the taskbar clock tooltip (date+time) (see strftime(3)
manpage).</p>
</div>
</li>
<li>
<p><code>TaskBarCPUSamples = 20</code></p>
<div class="paragraph">
<p>Width of CPU Monitor.</p>
</div>
</li>
<li>
<p><code>TaskBarMEMSamples = 20</code></p>
<div class="paragraph">
<p>Width of Memory Monitor.</p>
</div>
</li>
<li>
<p><code>TaskBarNetSamples = 20</code></p>
<div class="paragraph">
<p>Width of Net Monitor.</p>
</div>
</li>
<li>
<p><code>TaskbarButtonWidthDivisor = 3</code></p>
<div class="paragraph">
<p>Default number of tasks in taskbar.</p>
</div>
</li>
<li>
<p><code>TaskBarWidthPercentage = 100</code></p>
<div class="paragraph">
<p>Task bar width as percentage of the screen width.</p>
</div>
</li>
<li>
<p><code>TaskBarJustify = "left"</code></p>
<div class="paragraph">
<p>Taskbar justify left, right or center.</p>
</div>
</li>
<li>
<p><code>TaskBarApmGraphWidth = 10</code></p>
<div class="paragraph">
<p>Width of APM Monitor.</p>
</div>
</li>
<li>
<p><code>TaskBarGraphHeight = 20</code></p>
<div class="paragraph">
<p>Height of taskbar monitoring applets.</p>
</div>
</li>
<li>
<p><code>XineramaPrimaryScreen = 0</code></p>
<div class="paragraph">
<p>Primary screen for xinerama (taskbar, &#8230;&#8203;).</p>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="mailbox-monitoring-updated-2018-03-04">Mailbox Monitoring (updated 2018-03-04)</h3>
<div class="ulist">
<ul>
<li>
<p><code>MailBoxPath = ""</code></p>
</li>
</ul>
</div>
<div class="paragraph">
<p>This may contain a list of mailbox specifications. Mailboxes are
separated by a space. If <code>TaskBarShowMailboxStatus</code> is enabled
then IceWM will monitor each mailbox for status changes each
<code>MailCheckDelay</code> seconds. For each mailbox IceWM will show an icon on
the taskbar. The icon shows if there is mail, if there is unread mail,
or if there is new mail. Hovering the mouse pointer over an icon shows
the number of messages in this mailbox and also the number unread
mails. A mailbox can be the path to a file in conventional <em>mbox</em>
format. If the path points to a directory then <em>Maildir</em> format is
assumed. Remote mail boxes are specified by an URL using the Common
Internet Scheme Syntax (RFC 1738):</p>
</div>
<div class="literalblock">
<div class="content">
<pre>scheme://user:password@server[:port][/path]</pre>
</div>
</div>
<div class="paragraph">
<p>Supported schemes are <code>pop3</code>, <code>pop3s</code>, <code>imap</code>, <code>imaps</code> and <code>file</code>. The
<code>pop3s</code> and <code>imaps</code> schemes depend on the presence of the <code>openssl</code>
command for <code>TLS/SSL</code> encryption. This is also the case if <code>port</code> is
either <code>993</code> for imap or <code>995</code> for pop3. When the scheme is omitted
then <code>file</code> is assumed. IMAP subfolders can be given by the path
component. Reserved characters like <em>slash</em>, <em>at</em> and <em>colon</em> can
be specified using escape sequences with a hexadecimal encoding like
<code>%2f</code> for the slash or <code>%40</code> for the at sign. For example:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>file:///var/spool/mail/captnmark
file:///home/captnmark/Maildir/
pop3://markus:%2f%40%3a@maol.ch/
pop3s://markus:password@pop.gmail.com/
imap://mathias@localhost/INBOX.Maillisten.icewm-user
imaps://mathias:password@imap.gmail.com/INBOX</pre>
</div>
</div>
<div class="paragraph">
<p>To help solve network protocol errors for pop3 and imap set the
environment variable <code>ICEWM_MAILCHECK_TRACE</code>. IceWM will then log
communication details for POP3 and IMAP mailboxes. Just set <code>export
ICEWM_MAILCHECK_TRACE=1</code> before executing icewm, or set this in the
<code>env</code> configuration file.</p>
</div>
<div class="paragraph">
<p>Note that for IceWM to access Gmail you must first configure your Gmail
account to enable POP3 or IMAP access. To allow non-Gmail applications
like IceWM to use it see the Gmail help site for "Let less secure
apps use your account". Also set secure file permissions on your
IceWM preferences file and the directory which contains it. It is
unwise to store a password on file ever. Consider a wallet extension
for IceWM. The following Perl snippet demonstrates how to hex encode
a password like <code>!p@a%s&amp;s~</code>:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>$ perl -e 'foreach(split("", $ARGV[0])) { printf "%%%02x", ord($_);  }; print "\n";' '!p@a%s&amp;s~'
%21%40%23%24%25%5e%26%2a%7e</pre>
</div>
</div>
</div>
<div class="sect2">
<h3 id="menus">Menus</h3>
<div class="ulist">
<ul>
<li>
<p><code>AutoReloadMenus = 1</code></p>
<div class="paragraph">
<p>Reload menu files automatically if set to 1.</p>
</div>
</li>
<li>
<p><code>ShowProgramsMenu = 0</code></p>
<div class="paragraph">
<p>Show programs submenu.</p>
</div>
</li>
<li>
<p><code>ShowSettingsMenu = 1</code></p>
<div class="paragraph">
<p>Show settings submenu.</p>
</div>
</li>
<li>
<p><code>ShowFocusModeMenu = 1</code></p>
<div class="paragraph">
<p>Show focus mode submenu.</p>
</div>
</li>
<li>
<p><code>ShowThemesMenu = 1</code></p>
<div class="paragraph">
<p>Show themes submenu.</p>
</div>
</li>
<li>
<p><code>ShowLogoutMenu = 1</code></p>
<div class="paragraph">
<p>Show logout menu.</p>
</div>
</li>
<li>
<p><code>ShowHelp = 1</code></p>
<div class="paragraph">
<p>Show the help menu item.</p>
</div>
</li>
<li>
<p><code>ShowLogoutSubMenu = 1</code></p>
<div class="paragraph">
<p>Show logout submenu.</p>
</div>
</li>
<li>
<p><code>ShowAbout = 1</code></p>
<div class="paragraph">
<p>Show the about menu item.</p>
</div>
</li>
<li>
<p><code>ShowRun = 1</code></p>
<div class="paragraph">
<p>Show the run menu item.</p>
</div>
</li>
<li>
<p><code>ShowWindowList = 1</code></p>
<div class="paragraph">
<p>Show the window menu item.</p>
</div>
</li>
<li>
<p><code>MenuMaximalWidth = 0</code></p>
<div class="paragraph">
<p>Maximal width of popup menus, 2/3 of the screen&#8217;s width if set to zero.</p>
</div>
</li>
<li>
<p><code>NestedThemeMenuMinNumber = 25</code></p>
<div class="paragraph">
<p>Minimal number of themes after which the Themes menu becomes nested
(0=disabled).</p>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="timings">Timings</h3>
<div class="ulist">
<ul>
<li>
<p><code>DelayFuzziness = 10</code></p>
<div class="paragraph">
<p>Percentage of delay/timeout fuzziness to allow for merging of timer
timeouts.</p>
</div>
</li>
<li>
<p><code>ClickMotionDistance = 5</code></p>
<div class="paragraph">
<p>Movement before click is interpreted as drag.</p>
</div>
</li>
<li>
<p><code>ClickMotionDelay = 200</code></p>
<div class="paragraph">
<p>Delay before click gets interpreted as drag.</p>
</div>
</li>
<li>
<p><code>MultiClickTime = 400</code></p>
<div class="paragraph">
<p>Time (ms) to recognize for double click.</p>
</div>
</li>
<li>
<p><code>MenuActivateDelay = 40</code></p>
<div class="paragraph">
<p>Delay before activating menu items.</p>
</div>
</li>
<li>
<p><code>SubmenuMenuActivateDelay = 300</code></p>
<div class="paragraph">
<p>Delay before activating menu submenus.</p>
</div>
</li>
<li>
<p><code>ToolTipDelay = 5000</code></p>
<div class="paragraph">
<p>Time before showing the tooltip.</p>
</div>
</li>
<li>
<p><code>ToolTipTime = 60000</code></p>
<div class="paragraph">
<p>Time before tooltip window is hidden (0 means never).</p>
</div>
</li>
<li>
<p><code>AutoHideDelay = 300</code></p>
<div class="paragraph">
<p>Time to auto hide taskbar (must enable first with TaskBarAutoHide).</p>
</div>
</li>
<li>
<p><code>AutoShowDelay = 500</code></p>
<div class="paragraph">
<p>Delay before task bar is shown.</p>
</div>
</li>
<li>
<p><code>AutoRaiseDelay = 400</code></p>
<div class="paragraph">
<p>Time to auto raise (must enable first with AutoRaise).</p>
</div>
</li>
<li>
<p><code>PointerFocusDelay = 200</code></p>
<div class="paragraph">
<p>Delay for pointer focus switching.</p>
</div>
</li>
<li>
<p><code>EdgeSwitchDelay = 600</code></p>
<div class="paragraph">
<p>Screen edge workspace switching delay.</p>
</div>
</li>
<li>
<p><code>ScrollBarStartDelay = 500</code></p>
<div class="paragraph">
<p>Initial scroll bar autoscroll delay</p>
</div>
</li>
<li>
<p><code>ScrollBarDelay = 30</code></p>
<div class="paragraph">
<p>Scroll bar autoscroll delay</p>
</div>
</li>
<li>
<p><code>AutoScrollStartDelay = 500</code></p>
<div class="paragraph">
<p>Auto scroll start delay</p>
</div>
</li>
<li>
<p><code>AutoScrollDelay = 60</code></p>
<div class="paragraph">
<p>Auto scroll delay</p>
</div>
</li>
<li>
<p><code>WorkspaceStatusTime = 2500</code></p>
<div class="paragraph">
<p>Time before workspace status window is hidden.</p>
</div>
</li>
<li>
<p><code>MailCheckDelay = 30</code></p>
<div class="paragraph">
<p>Delay between new-mail checks. (seconds).</p>
</div>
</li>
<li>
<p><code>TaskBarCPUDelay = 500</code></p>
<div class="paragraph">
<p>Delay between CPU Monitor samples in ms.</p>
</div>
</li>
<li>
<p><code>TaskBarMEMDelay = 500</code></p>
<div class="paragraph">
<p>Delay between Memory Monitor samples in ms.</p>
</div>
</li>
<li>
<p><code>TaskBarNetDelay = 500</code></p>
<div class="paragraph">
<p>Delay between Net Monitor samples in ms.</p>
</div>
</li>
<li>
<p><code>FocusRequestFlashTime = 0</code></p>
<div class="paragraph">
<p>Number of seconds the taskbar app will blink when requesting focus
(0 = forever).</p>
</div>
</li>
<li>
<p><code>FocusRequestFlashInterval = 250</code></p>
<div class="paragraph">
<p>Taskbar blink interval (ms) when requesting focus (0 = blinking
disabled).</p>
</div>
</li>
<li>
<p><code>BatteryPollingPeriod = 10</code></p>
<div class="paragraph">
<p>Delay between power status updates (seconds).</p>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="buttons-and-keys">Buttons and Keys</h3>
<div class="ulist">
<ul>
<li>
<p><code>UseRootButtons = 255</code></p>
<div class="paragraph">
<p>Bitmask of root window button click to use in window manager.</p>
</div>
</li>
<li>
<p><code>ButtonRaiseMask = 1</code></p>
<div class="paragraph">
<p>Bitmask of buttons that raise the window when pressed.</p>
</div>
</li>
<li>
<p><code>DesktopWinMenuButton = 0</code></p>
<div class="paragraph">
<p>Desktop mouse-button click to show the window list menu.</p>
</div>
</li>
<li>
<p><code>DesktopWinListButton = 2</code></p>
<div class="paragraph">
<p>Desktop mouse-button click to show the window list.</p>
</div>
</li>
<li>
<p><code>DesktopMenuButton = 3</code></p>
<div class="paragraph">
<p>Desktop mouse-button click to show the root menu.</p>
</div>
</li>
<li>
<p><code>TitleBarMaximizeButton = 1</code></p>
<div class="paragraph">
<p>TitleBar mouse-button double click to maximize the window.</p>
</div>
</li>
<li>
<p><code>TitleBarRollupButton = 2</code></p>
<div class="paragraph">
<p>TitleBar mouse-button double click to rollup the window.</p>
</div>
</li>
<li>
<p><code>RolloverButtonsSupported = 0</code></p>
<div class="paragraph">
<p>Does it support the 'O' title bar button images (for mouse rollover)</p>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="workspaces">Workspaces</h3>
<div class="ulist">
<ul>
<li>
<p>WorkspaceNames</p>
<div class="paragraph">
<p>List of workspace names, for example:</p>
</div>
<div class="paragraph">
<p>WorkspaceNames=" 1 ", " 2 ", " 3 ", " 4 "</p>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="paths">Paths</h3>
<div class="ulist">
<ul>
<li>
<p>LibPath</p>
<div class="paragraph">
<p>Path to the icewm/lib directory.</p>
</div>
</li>
<li>
<p>IconPath</p>
<div class="paragraph">
<p>Path to the icon directory. Multiple paths can be given using the
colon as a separator.</p>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="programs">Programs</h3>
<div class="ulist">
<ul>
<li>
<p>ClockCommand</p>
<div class="paragraph">
<p>program to run when the clock is double clicked.</p>
</div>
</li>
<li>
<p>MailCommand</p>
<div class="paragraph">
<p>program to run when mailbox icon is double clicked.</p>
</div>
</li>
<li>
<p>LockCommand</p>
<div class="paragraph">
<p>program to run to lock the screen.</p>
</div>
</li>
<li>
<p>RunCommand</p>
<div class="paragraph">
<p>program to run when <strong>Run</strong> is selected from the start menu.</p>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="window-menus">Window Menus</h3>
<div class="paragraph">
<p>WinMenuItems
Items to show in the window menus, posible values are:</p>
</div>
<div class="ulist">
<ul>
<li>
<p>`  a=rAise`</p>
</li>
<li>
<p>`  c=Close`</p>
</li>
<li>
<p>`  f=Fullscreen`</p>
</li>
<li>
<p>`  h=Hide`</p>
</li>
<li>
<p>`  i=trayIcon`</p>
</li>
<li>
<p>`  k=Kill`</p>
</li>
<li>
<p>`  l=Lower`</p>
</li>
<li>
<p>`  m=Move`</p>
</li>
<li>
<p>`  n=miNimize`</p>
</li>
<li>
<p>`  r=Restore`</p>
</li>
<li>
<p>`  s=Size`</p>
</li>
<li>
<p>`  t=moveTo`</p>
</li>
<li>
<p>`  u=rollUp`</p>
</li>
<li>
<p>`  w=WindowsList`</p>
</li>
<li>
<p>`  x=maXimize`</p>
</li>
<li>
<p>`  y=laYer`</p>
<div class="paragraph">
<p>Examples:</p>
</div>
<div class="paragraph">
<p>WinMenuItems=rmsnxfhualyticw   #Default menu
  WinMenuItems=rmsnxfhualytickw  #Menu with all possible options
  WinMenuItems=rmsnxc            #MS-Windows menu</p>
</div>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="theme-settings">Theme Settings</h2>
<div class="sectionbody">
<div class="paragraph">
<p>This section shows settings that can be set in theme files. They can
also be set in <code>preferences</code> file but themes will override the values
set there. To override the theme values the settings should be set in
<code>prefoverride</code> file. Default values are shown following the equal sign.</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>ThemeAuthor =</code></p>
<div class="paragraph">
<p>Theme author, e-mail address, credits.</p>
</div>
</li>
<li>
<p><code>ThemeDescription =</code></p>
<div class="paragraph">
<p>Description of the theme, credits.</p>
</div>
</li>
<li>
<p><code>Gradients =</code></p>
<div class="paragraph">
<p>List of gradient pixmaps in the current theme.</p>
</div>
</li>
</ul>
</div>
<div class="sect2">
<h3 id="borders">Borders</h3>
<div class="paragraph">
<p>The following settings can be set to a numeric value.</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>BorderSizeX = 6</code></p>
<div class="paragraph">
<p>Left/right border width.</p>
</div>
</li>
<li>
<p><code>BorderSizeY = 6</code></p>
<div class="paragraph">
<p>Top/bottom border height.</p>
</div>
</li>
<li>
<p><code>DlgBorderSizeX = 2</code></p>
<div class="paragraph">
<p>Left/right border width of non-resizable windows.</p>
</div>
</li>
<li>
<p><code>DlgBorderSizeY = 2</code></p>
<div class="paragraph">
<p>Top/bottom border height of non-resizable windows.</p>
</div>
</li>
<li>
<p><code>CornerSizeX = 24</code></p>
<div class="paragraph">
<p>Width of the window corner.</p>
</div>
</li>
<li>
<p><code>CornerSizeY = 24</code></p>
<div class="paragraph">
<p>Height of the window corner.</p>
</div>
</li>
<li>
<p><code>TitleBarHeight = 20</code></p>
<div class="paragraph">
<p>Height of the title bar.</p>
</div>
</li>
<li>
<p><code>TitleBarJustify = 0</code></p>
<div class="paragraph">
<p>Justification of the window title.</p>
</div>
</li>
<li>
<p><code>TitleBarHorzOffset = 0</code></p>
<div class="paragraph">
<p>Horizontal offset for the window title text.</p>
</div>
</li>
<li>
<p><code>TitleBarVertOffset = 0</code></p>
<div class="paragraph">
<p>Vertical offset for the window title text.</p>
</div>
</li>
<li>
<p><code>TitleBarCentered = 0</code></p>
<div class="paragraph">
<p>Draw window title centered (obsoleted by TitleBarJustify)</p>
</div>
</li>
<li>
<p><code>TitleBarJoinLeft = 0</code></p>
<div class="paragraph">
<p>Join title*S and title*T</p>
</div>
</li>
<li>
<p><code>TitleBarJoinRight = 0</code></p>
<div class="paragraph">
<p>Join title*T and title*B</p>
</div>
</li>
<li>
<p><code>ScrollBarX = 16</code></p>
<div class="paragraph">
<p>Scrollbar width.</p>
</div>
</li>
<li>
<p><code>ScrollBarY = 16</code></p>
<div class="paragraph">
<p>Scrollbar (button) height.</p>
</div>
</li>
<li>
<p><code>MenuIconSize = 16</code></p>
<div class="paragraph">
<p>Menu icon size.</p>
</div>
</li>
<li>
<p><code>SmallIconSize = 16</code></p>
<div class="paragraph">
<p>Dimension of the small icons.</p>
</div>
</li>
<li>
<p><code>LargeIconSize = 32</code></p>
<div class="paragraph">
<p>Dimension of the large icons.</p>
</div>
</li>
<li>
<p><code>HugeIconSize = 48</code></p>
<div class="paragraph">
<p>Dimension of the large icons.</p>
</div>
</li>
<li>
<p><code>QuickSwitchHorzMargin = 3</code></p>
<div class="paragraph">
<p>Horizontal margin of the quickswitch window.</p>
</div>
</li>
<li>
<p><code>QuickSwitchVertMargin = 3</code></p>
<div class="paragraph">
<p>Vertical margin of the quickswitch window.</p>
</div>
</li>
<li>
<p><code>QuickSwitchIconMargin = 4</code></p>
<div class="paragraph">
<p>Vertical margin in the quickswitch window.</p>
</div>
</li>
<li>
<p><code>QuickSwitchIconBorder = 2</code></p>
<div class="paragraph">
<p>Distance between the active icon and it&#8217;s border.</p>
</div>
</li>
<li>
<p><code>QuickSwitchSeparatorSize = 6</code></p>
<div class="paragraph">
<p>Height of the separator between (all reachable) icons and text,
0 to avoid it.</p>
</div>
</li>
<li>
<p><code>ShowMenuButtonIcon = 1</code></p>
<div class="paragraph">
<p>Show application icon over menu button.</p>
</div>
</li>
<li>
<p><code>TitleButtonsLeft = "s"</code></p>
<div class="paragraph">
<p>Titlebar buttons from left to right (x=close, m=max, i=min, h=hide,
r=rollup, s=sysmenu, d=depth).</p>
</div>
</li>
<li>
<p><code>TitleButtonsRight = "xmir"</code></p>
<div class="paragraph">
<p>Titlebar buttons from right to left (x=close, m=max, i=min, h=hide,
r=rollup, s=sysmenu, d=depth).</p>
</div>
</li>
<li>
<p><code>TitleButtonsSupported = "xmis"</code></p>
<div class="paragraph">
<p>Titlebar buttons supported by theme (x,m,i,r,h,s,d).</p>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="fonts">Fonts</h3>
<div class="paragraph">
<p>The following settings can be set to a string value.</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>TitleFontName = "-<strong>-sans-medium-r-</strong>-<strong>-</strong>-120-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the title bar font.</p>
</div>
</li>
<li>
<p><code>MenuFontName = "-<strong>-sans-bold-r-</strong>-<strong>-</strong>-100-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the menu font.</p>
</div>
</li>
<li>
<p><code>StatusFontName = "-<strong>-monospace-bold-r-</strong>-<strong>-</strong>-120-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the status display font.</p>
</div>
</li>
<li>
<p><code>QuickSwitchFontName = "-<strong>-monospace-bold-r-</strong>-<strong>-</strong>-120-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the font for Alt+Tab switcher window.</p>
</div>
</li>
<li>
<p><code>NormalButtonFontName = "-<strong>-sans-medium-r-</strong>-<strong>-</strong>-120-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the normal button font.</p>
</div>
</li>
<li>
<p><code>ActiveButtonFontName = "-<strong>-sans-bold-r-</strong>-<strong>-</strong>-120-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the active button font.</p>
</div>
</li>
<li>
<p><code>NormalTaskBarFontName = "-<strong>-sans-medium-r-</strong>-<strong>-</strong>-120-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the normal task bar item font.</p>
</div>
</li>
<li>
<p><code>ActiveTaskBarFontName = "-<strong>-sans-bold-r-</strong>-<strong>-</strong>-120-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the active task bar item font.</p>
</div>
</li>
<li>
<p><code>ToolButtonFontName = "-<strong>-sans-medium-r-</strong>-<strong>-</strong>-120-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the tool button font (fallback: NormalButtonFontName).</p>
</div>
</li>
<li>
<p><code>NormalWorkspaceFontName = "-<strong>-sans-medium-r-</strong>-<strong>-</strong>-120-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the normal workspace button font (fallback:
NormalButtonFontName).</p>
</div>
</li>
<li>
<p><code>ActiveWorkspaceFontName = "-<strong>-sans-medium-r-</strong>-<strong>-</strong>-120-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the active workspace button font (fallback:
ActiveButtonFontName).</p>
</div>
</li>
<li>
<p><code>MinimizedWindowFontName = "-<strong>-sans-medium-r-</strong>-<strong>-</strong>-120-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the mini-window font.</p>
</div>
</li>
<li>
<p><code>ListBoxFontName = "-<strong>-sans-medium-r-</strong>-<strong>-</strong>-120-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the window list font.</p>
</div>
</li>
<li>
<p><code>ToolTipFontName = "-<strong>-sans-medium-r-</strong>-<strong>-</strong>-120-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the tool tip font.</p>
</div>
</li>
<li>
<p><code>ClockFontName = "-<strong>-monospace-medium-r-</strong>-<strong>-</strong>-140-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the task bar clock font.</p>
</div>
</li>
<li>
<p><code>TempFontName = "-<strong>-monospace-medium-r-</strong>-<strong>-</strong>-140-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the task bar temperature font.</p>
</div>
</li>
<li>
<p><code>ApmFontName = "-<strong>-monospace-medium-r-</strong>-<strong>-</strong>-140-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the task bar battery font.</p>
</div>
</li>
<li>
<p><code>InputFontName = "-<strong>-monospace-medium-r-</strong>-<strong>-</strong>-140-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the input field font.</p>
</div>
</li>
<li>
<p><code>LabelFontName = "-<strong>-sans-medium-r-</strong>-<strong>-</strong>-140-<strong>-</strong>-<strong>-</strong>-<strong>-</strong>"</code></p>
<div class="paragraph">
<p>Name of the label font.</p>
</div>
</li>
</ul>
</div>
<div class="paragraph">
<p>When IceWM is configured with <code>--enable-xfreetype</code>, only the settings
with "Xft" suffix will be used. They specifiy the font name in
fontconfig format:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>MenuFontNameXft="sans-serif:size=12:bold"</pre>
</div>
</div>
<div class="ulist">
<ul>
<li>
<p><code>TitleFontNameXft = "sans-serif:size=12"</code></p>
<div class="paragraph">
<p>Name of the title bar font.</p>
</div>
</li>
<li>
<p><code>MenuFontNameXft = "sans-serif:size=10:bold"</code></p>
<div class="paragraph">
<p>Name of the menu font.</p>
</div>
</li>
<li>
<p><code>StatusFontNameXft = "monospace:size=12:bold"</code></p>
<div class="paragraph">
<p>Name of the status display font.</p>
</div>
</li>
<li>
<p><code>QuickSwitchFontNameXft = "monospace:size=12:bold"</code></p>
<div class="paragraph">
<p>Name of the font for Alt+Tab switcher window.</p>
</div>
</li>
<li>
<p><code>NormalButtonFontNameXft = "sans-serif:size=12"</code></p>
<div class="paragraph">
<p>Name of the normal button font.</p>
</div>
</li>
<li>
<p><code>ActiveButtonFontNameXft = "sans-serif:size=12:bold"</code></p>
<div class="paragraph">
<p>Name of the active button font.</p>
</div>
</li>
<li>
<p><code>NormalTaskBarFontNameXft = "sans-serif:size=12"</code></p>
<div class="paragraph">
<p>Name of the normal task bar item font.</p>
</div>
</li>
<li>
<p><code>ActiveTaskBarFontNameXft = "sans-serif:size=12:bold"</code></p>
<div class="paragraph">
<p>Name of the active task bar item font.</p>
</div>
</li>
<li>
<p><code>ToolButtonFontNameXft = "sans-serif:size=12"</code></p>
<div class="paragraph">
<p>Name of the tool button font (fallback: NormalButtonFontNameXft).</p>
</div>
</li>
<li>
<p><code>NormalWorkspaceFontNameXft = "sans-serif:size=12"</code></p>
<div class="paragraph">
<p>Name of the normal workspace button font (fallback:
NormalButtonFontNameXft).</p>
</div>
</li>
<li>
<p><code>ActiveWorkspaceFontNameXft = "sans-serif:size=12"</code></p>
<div class="paragraph">
<p>Name of the active workspace button font (fallback:
ActiveButtonFontNameXft).</p>
</div>
</li>
<li>
<p><code>MinimizedWindowFontNameXft = "sans-serif:size=12"</code></p>
<div class="paragraph">
<p>Name of the mini-window font.</p>
</div>
</li>
<li>
<p><code>ListBoxFontNameXft = "sans-serif:size=12"</code></p>
<div class="paragraph">
<p>Name of the window list font.</p>
</div>
</li>
<li>
<p><code>ToolTipFontNameXft = "sans-serif:size=12"</code></p>
<div class="paragraph">
<p>Name of the tool tip font.</p>
</div>
</li>
<li>
<p><code>ClockFontNameXft = "monospace:size=12"</code></p>
<div class="paragraph">
<p>Name of the task bar clock font.</p>
</div>
</li>
<li>
<p><code>TempFontNameXft = "monospace:size=12"</code></p>
<div class="paragraph">
<p>Name of the task bar temperature font.</p>
</div>
</li>
<li>
<p><code>ApmFontNameXft = "monospace:size=12"</code></p>
<div class="paragraph">
<p>Name of the task bar battery font.</p>
</div>
</li>
<li>
<p><code>InputFontNameXft = "monospace:size=12"</code></p>
<div class="paragraph">
<p>Name of the input field font.</p>
</div>
</li>
<li>
<p><code>LabelFontNameXft = "sans-serif:size=12"</code></p>
<div class="paragraph">
<p>Name of the label font.</p>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="colors">Colors</h3>
<div class="ulist">
<ul>
<li>
<p><code>ColorDialog = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background of dialog windows.</p>
</div>
</li>
<li>
<p><code>ColorNormalBorder = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Border of inactive windows.</p>
</div>
</li>
<li>
<p><code>ColorActiveBorder = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Border of active windows.</p>
</div>
</li>
<li>
<p><code>ColorNormalButton = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background of regular buttons.</p>
</div>
</li>
<li>
<p><code>ColorNormalButtonText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor of regular buttons.</p>
</div>
</li>
<li>
<p><code>ColorActiveButton = "rgb:E0/E0/E0"</code></p>
<div class="paragraph">
<p>Background of pressed buttons.</p>
</div>
</li>
<li>
<p><code>ColorActiveButtonText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor of pressed buttons.</p>
</div>
</li>
<li>
<p><code>ColorNormalTitleButton = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background of titlebar buttons.</p>
</div>
</li>
<li>
<p><code>ColorNormalTitleButtonText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor of titlebar buttons.</p>
</div>
</li>
<li>
<p><code>ColorToolButton = ""</code></p>
<div class="paragraph">
<p>Background of toolbar buttons, ColorNormalButton is used if empty.</p>
</div>
</li>
<li>
<p><code>ColorToolButtonText = ""</code></p>
<div class="paragraph">
<p>Textcolor of toolbar buttons, ColorNormalButtonText is used if empty.</p>
</div>
</li>
<li>
<p><code>ColorNormalWorkspaceButton = ""</code></p>
<div class="paragraph">
<p>Background of workspace buttons, ColorNormalButton is used if empty.</p>
</div>
</li>
<li>
<p><code>ColorNormalWorkspaceButtonText = ""</code></p>
<div class="paragraph">
<p>Textcolor of workspace buttons, ColorNormalButtonText is used if empty.</p>
</div>
</li>
<li>
<p><code>ColorActiveWorkspaceButton = ""</code></p>
<div class="paragraph">
<p>Background of the active workspace button, ColorActiveButton is used
if empty.</p>
</div>
</li>
<li>
<p><code>ColorActiveWorkspaceButtonText = ""</code></p>
<div class="paragraph">
<p>Textcolor of the active workspace button, ColorActiveButtonText is
used if empty.</p>
</div>
</li>
<li>
<p><code>ColorNormalTitleBar = "rgb:80/80/80"</code></p>
<div class="paragraph">
<p>Background of the titlebar of regular windows.</p>
</div>
</li>
<li>
<p><code>ColorNormalTitleBarText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor of the titlebar of regular windows.</p>
</div>
</li>
<li>
<p><code>ColorNormalTitleBarShadow = ""</code></p>
<div class="paragraph">
<p>Textshadow of the titlebar of regular windows.</p>
</div>
</li>
<li>
<p><code>ColorActiveTitleBar = "rgb:00/00/A0"</code></p>
<div class="paragraph">
<p>Background of the titlebar of active windows.</p>
</div>
</li>
<li>
<p><code>ColorActiveTitleBarText = "rgb:FF/FF/FF"</code></p>
<div class="paragraph">
<p>Textcolor of the titlebar of active windows.</p>
</div>
</li>
<li>
<p><code>ColorActiveTitleBarShadow = ""</code></p>
<div class="paragraph">
<p>Textshadow of the titlebar of active windows.</p>
</div>
</li>
<li>
<p><code>ColorNormalMinimizedWindow = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background for mini icons of regular windows.</p>
</div>
</li>
<li>
<p><code>ColorNormalMinimizedWindowText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor for mini icons of regular windows.</p>
</div>
</li>
<li>
<p><code>ColorActiveMinimizedWindow = "rgb:E0/E0/E0"</code></p>
<div class="paragraph">
<p>Background for mini icons of active windows.</p>
</div>
</li>
<li>
<p><code>ColorActiveMinimizedWindowText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor for mini icons of active windows.</p>
</div>
</li>
<li>
<p><code>ColorNormalMenu = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background of pop-up menus.</p>
</div>
</li>
<li>
<p><code>ColorNormalMenuItemText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor of regular menu items.</p>
</div>
</li>
<li>
<p><code>ColorActiveMenuItem = "rgb:A0/A0/A0"</code></p>
<div class="paragraph">
<p>Background of selected menu item, leave empty to force transparency.</p>
</div>
</li>
<li>
<p><code>ColorActiveMenuItemText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor of selected menu items.</p>
</div>
</li>
<li>
<p><code>ColorDisabledMenuItemText = "rgb:80/80/80"</code></p>
<div class="paragraph">
<p>Textcolor of disabled menu items.</p>
</div>
</li>
<li>
<p><code>ColorDisabledMenuItemShadow = ""</code></p>
<div class="paragraph">
<p>Shadow of regular menu items.</p>
</div>
</li>
<li>
<p><code>ColorMoveSizeStatus = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background of move/resize status window.</p>
</div>
</li>
<li>
<p><code>ColorMoveSizeStatusText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor of move/resize status window.</p>
</div>
</li>
<li>
<p><code>ColorQuickSwitch = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background of the quick switch window.</p>
</div>
</li>
<li>
<p><code>ColorQuickSwitchText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor in the quick switch window.</p>
</div>
</li>
<li>
<p><code>ColorQuickSwitchActive = ""</code></p>
<div class="paragraph">
<p>Rectangle arround the active icon in the quick switch window.</p>
</div>
</li>
<li>
<p><code>ColorDefaultTaskBar = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background of the taskbar.</p>
</div>
</li>
<li>
<p><code>ColorNormalTaskBarApp = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background for task buttons of regular windows.</p>
</div>
</li>
<li>
<p><code>ColorNormalTaskBarAppText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor for task buttons of regular windows.</p>
</div>
</li>
<li>
<p><code>ColorActiveTaskBarApp = "rgb:E0/E0/E0"</code></p>
<div class="paragraph">
<p>Background for task buttons of the active window.</p>
</div>
</li>
<li>
<p><code>ColorActiveTaskBarAppText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor for task buttons of the active window.</p>
</div>
</li>
<li>
<p><code>ColorMinimizedTaskBarApp = "rgb:A0/A0/A0"</code></p>
<div class="paragraph">
<p>Background for task buttons of minimized windows.</p>
</div>
</li>
<li>
<p><code>ColorMinimizedTaskBarAppText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor for task buttons of minimized windows.</p>
</div>
</li>
<li>
<p><code>ColorInvisibleTaskBarApp = "rgb:80/80/80"</code></p>
<div class="paragraph">
<p>Background for task buttons of windows on other workspaces.</p>
</div>
</li>
<li>
<p><code>ColorInvisibleTaskBarAppText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor for task buttons of windows on other workspaces.</p>
</div>
</li>
<li>
<p><code>ColorScrollBar = "rgb:A0/A0/A0"</code></p>
<div class="paragraph">
<p>Scrollbar background (sliding area).</p>
</div>
</li>
<li>
<p><code>ColorScrollBarSlider = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background of the slider button in scrollbars.</p>
</div>
</li>
<li>
<p><code>ColorScrollBarButton = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background of the arrow buttons in scrollbars.</p>
</div>
</li>
<li>
<p><code>ColorScrollBarArrow = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background of the arrow buttons in scrollbars (obsolete).</p>
</div>
</li>
<li>
<p><code>ColorScrollBarButtonArrow = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Color of active arrows on scrollbar buttons.</p>
</div>
</li>
<li>
<p><code>ColorScrollBarInactiveArrow = "rgb:80/80/80"</code></p>
<div class="paragraph">
<p>Color of inactive arrows on scrollbar buttons.</p>
</div>
</li>
<li>
<p><code>ColorListBox = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background of listboxes.</p>
</div>
</li>
<li>
<p><code>ColorListBoxText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor in listboxes.</p>
</div>
</li>
<li>
<p><code>ColorListBoxSelection = "rgb:80/80/80"</code></p>
<div class="paragraph">
<p>Background of selected listbox items.</p>
</div>
</li>
<li>
<p><code>ColorListBoxSelectionText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor of selected listbox items.</p>
</div>
</li>
<li>
<p><code>ColorToolTip = "rgb:E0/E0/00"</code></p>
<div class="paragraph">
<p>Background of tooltips.</p>
</div>
</li>
<li>
<p><code>ColorToolTipText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor of tooltips.</p>
</div>
</li>
<li>
<p><code>ColorLabel = "rgb:C0/C0/C0"</code></p>
<div class="paragraph">
<p>Background of labels, leave empty to force transparency.</p>
</div>
</li>
<li>
<p><code>ColorLabelText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor of labels.</p>
</div>
</li>
<li>
<p><code>ColorInput = "rgb:FF/FF/FF"</code></p>
<div class="paragraph">
<p>Background of text entry fields (e.g. the addressbar).</p>
</div>
</li>
<li>
<p><code>ColorInputText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Textcolor of text entry fields (e.g. the addressbar).</p>
</div>
</li>
<li>
<p><code>ColorInputSelection = "rgb:80/80/80"</code></p>
<div class="paragraph">
<p>Background of selected text in an entry field.</p>
</div>
</li>
<li>
<p><code>ColorInputSelectionText = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Selected text in an entry field.</p>
</div>
</li>
<li>
<p><code>ColorClock = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Background of non-LCD clock, leave empty to force transparency.</p>
</div>
</li>
<li>
<p><code>ColorClockText = "rgb:00/FF/00"</code></p>
<div class="paragraph">
<p>Background of non-LCD monitor.</p>
</div>
</li>
<li>
<p><code>ColorApm = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Background of APM monitor, leave empty to force transparency.</p>
</div>
</li>
<li>
<p><code>ColorApmText = "rgb:00/FF/00"</code></p>
<div class="paragraph">
<p>Textcolor of APM monitor.</p>
</div>
</li>
<li>
<p><code>ColorApmBattary = "rgb:FF/FF/00"</code></p>
<div class="paragraph">
<p>Color of APM monitor in battary mode.</p>
</div>
</li>
<li>
<p><code>ColorApmLine = "rgb:00/FF/00"</code></p>
<div class="paragraph">
<p>Color of APM monitor in line mode.</p>
</div>
</li>
<li>
<p><code>ColorApmGraphBg = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Background color for graph mode.</p>
</div>
</li>
<li>
<p><code>ColorCPUStatusUser = "rgb:00/FF/00"</code></p>
<div class="paragraph">
<p>User load on the CPU monitor.</p>
</div>
</li>
<li>
<p><code>ColorCPUStatusSystem = "rgb:FF/00/00"</code></p>
<div class="paragraph">
<p>System load on the CPU monitor.</p>
</div>
</li>
<li>
<p><code>ColorCPUStatusInterrupts = "rgb:FF/FF/00"</code></p>
<div class="paragraph">
<p>Interrupts on the CPU monitor.</p>
</div>
</li>
<li>
<p><code>ColorCPUStatusIoWait = "rgb:60/00/60"</code></p>
<div class="paragraph">
<p>IO Wait on the CPU monitor.</p>
</div>
</li>
<li>
<p><code>ColorCPUStatusSoftIrq = "rgb:00/FF/FF"</code></p>
<div class="paragraph">
<p>Soft Interrupts on the CPU monitor.</p>
</div>
</li>
<li>
<p><code>ColorCPUStatusNice = "rgb:00/00/FF"</code></p>
<div class="paragraph">
<p>Nice load on the CPU monitor.</p>
</div>
</li>
<li>
<p><code>ColorCPUStatusIdle = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Idle (non) load on the CPU monitor, leave empty to force transparency.</p>
</div>
</li>
<li>
<p><code>ColorCPUStatusSteal = "rgb:FF/8A/91"</code></p>
<div class="paragraph">
<p>Involuntary Wait on the CPU monitor.</p>
</div>
</li>
<li>
<p><code>ColorCPUStatusTemp = "rgb:60/60/C0"</code></p>
<div class="paragraph">
<p>Temperature of the CPU.</p>
</div>
</li>
<li>
<p><code>ColorMEMStatusUser = "rgb:40/40/80"</code></p>
<div class="paragraph">
<p>User program usage in the memory monitor.</p>
</div>
</li>
<li>
<p><code>ColorMEMStatusBuffers = "rgb:60/60/C0"</code></p>
<div class="paragraph">
<p>OS buffers usage in the memory monitor.</p>
</div>
</li>
<li>
<p><code>ColorMEMStatusCached = "rgb:80/80/FF"</code></p>
<div class="paragraph">
<p>OS cached usage in the memory monitor.</p>
</div>
</li>
<li>
<p><code>ColorMEMStatusFree = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Free memory in the memory monitor.</p>
</div>
</li>
<li>
<p><code>ColorNetSend = "rgb:FF/FF/00"</code></p>
<div class="paragraph">
<p>Outgoing load on the network monitor.</p>
</div>
</li>
<li>
<p><code>ColorNetReceive = "rgb:FF/00/FF"</code></p>
<div class="paragraph">
<p>Incoming load on the network monitor.</p>
</div>
</li>
<li>
<p><code>ColorNetIdle = "rgb:00/00/00"</code></p>
<div class="paragraph">
<p>Idle (non) load on the network monitor, leave empty to force
transparency.</p>
</div>
</li>
<li>
<p><code>ColorApmBattery = rgb:FF/FF/00</code></p>
<div class="paragraph">
<p>Color of APM monitor in battery mode.</p>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="desktop-background">Desktop Background</h3>
<div class="paragraph">
<p>The following options are used by <code>icewmbg</code>:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>DesktopBackgroundCenter = 0</code></p>
<div class="paragraph">
<p>Display desktop background centered and not tiled. (set to 0 or 1).</p>
</div>
</li>
<li>
<p><code>DesktopBackgroundScaled = 0</code></p>
<div class="paragraph">
<p>Resize desktop background to full screen.</p>
</div>
</li>
<li>
<p><code>DesktopBackgroundColor = ""</code></p>
<div class="paragraph">
<p>Color(s) of the desktop background.</p>
</div>
</li>
<li>
<p><code>DesktopBackgroundImage = ""</code></p>
<div class="paragraph">
<p>Image(s) for desktop background. If you want IceWM to ignore the
desktop background image / color set both DesktopBackgroundColor and
DesktopBackgroundImage to an empty value ("").</p>
</div>
</li>
<li>
<p><code>SupportSemitransparency = 1</code></p>
<div class="paragraph">
<p>Support for semitransparent terminals like Eterm or gnome-terminal.</p>
</div>
</li>
<li>
<p><code>DesktopTransparencyColor = ""</code></p>
<div class="paragraph">
<p>Color(s) to announce for semitransparent windows.</p>
</div>
</li>
<li>
<p><code>DesktopTransparencyImage = ""</code></p>
<div class="paragraph">
<p>Image(s) to announce for semitransparent windows.</p>
</div>
</li>
<li>
<p><code>DesktopBackgroundMultihead = 0</code></p>
<div class="paragraph">
<p>Paint the background image over all multihead monitors combined.</p>
</div>
</li>
</ul>
</div>
</div>
<div class="sect2">
<h3 id="task-bar-2">Task Bar</h3>
<div class="ulist">
<ul>
<li>
<p><code>TaskBarClockLeds = 1</code></p>
<div class="paragraph">
<p>Display clock using LCD style pixmaps.</p>
</div>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="menus-and-toolbar-updated-2018-05-06">Menus and Toolbar (updated 2018-05-06)</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="menu">menu</h3>
<div class="paragraph">
<p>Within the <code>menu</code> configuration file you can configure which programs
are to appear in the root/start menu.</p>
</div>
<div class="paragraph">
<p>Submenus can be created with:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>menu "title" icon_name {
# contained items
}
separator
menufile "title" icon_name filename
menuprog "title" icon_name program arguments
menuprogreload "title" icon_name timeout program arguments
include filename
includeprog program arguments</pre>
</div>
</div>
<div class="paragraph">
<p>Menus can be populated with submenus and with program entries as
explained below for the <code>program</code> configuration file. Comments start
with a #-sign.</p>
</div>
<div class="paragraph">
<p>The <code>menufile</code> directive creates a submenu with a title and an
icon, while <code>menuprog</code> and <code>menuprogreload</code> create a submenu with
entries from the output of <code>program arguments</code> where the timeout
of <code>menuprogreload</code> says to reload the submenu after the timeout
expires. The <code>include</code> statement loads more configuration from the
given filename, while <code>includeprog</code> runs <code>program arguments</code> to parse
the output.</p>
</div>
</div>
<div class="sect2">
<h3 id="toolbar">toolbar</h3>
<div class="paragraph">
<p>The <code>toolbar</code> configuration file is used to put programs as buttons
on the taskbar. It uses the same syntax as the <code>menu</code> file.</p>
</div>
</div>
<div class="sect2">
<h3 id="programs-2">programs</h3>
<div class="paragraph">
<p>Usually automatically generated menu configuration file of installed
programs. The <code>programs</code> file should be automatically generated by
<code>wmconfig</code> (Redhat), <code>menu</code> (Debian), or <code>icewm-menu-fdo</code>.</p>
</div>
<div class="paragraph">
<p>Programs can be added using the following syntax:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>prog "title" icon_name program_executable options</pre>
</div>
</div>
<div class="paragraph">
<p>Restarting another window manager can be done using the restart
program:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>restart "title" icon_name program_executable options</pre>
</div>
</div>
<div class="paragraph">
<p>icon_name can be <code>-</code> if icon is not wanted, or <code>!</code> if the icon name
shall be guessed by checking the command (i.e. the real executable
file, following symlinks as needed).</p>
</div>
<div class="paragraph">
<p>The "runonce" keyword allows to launch an application only when no
window has the WM_CLASS hint specified. Otherwise the first window
having this class hint is mapped and raised. Syntax:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>runonce "title" icon_name "res_name.res_class" program_executable
options
runonce "title" icon_name "res_name" program_executable options
runonce "title" icon_name ".res_class" program_executable options</pre>
</div>
</div>
<div class="paragraph">
<p>The class hint of an application window can be figured out by running</p>
</div>
<div class="literalblock">
<div class="content">
<pre>$ xprop WM_CLASS</pre>
</div>
</div>
<div class="paragraph">
<p>Submenus can be added using the same keywords as the <code>menu</code>
configuration file.</p>
</div>
<div class="paragraph">
<p>Only double quotes are interpreted by IceWM. IceWM doesn&#8217;t run the
shell automatically, so you may have to do that.</p>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="hot-keys">Hot Keys</h2>
<div class="sectionbody">
<div class="paragraph">
<p>IceWM allows launching of arbitrary programs with any key
combination. This is configured in the <code>keys</code> file. The syntax of
this file is like:</p>
</div>
<div class="paragraph">
<p><strong>key</strong> "key combination" program options&#8230;&#8203;</p>
</div>
<div class="paragraph">
<p>For example:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>key  "Alt+Ctrl+t"  xterm -rv
key "Ctrl+Shift+r" icewm --restart
runonce "Alt+F12"  "res_name.res_class" program_executable options</pre>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="window-options-updated-2018-03-04">Window Options (updated 2018-03-04)</h2>
<div class="sectionbody">
<div class="paragraph">
<p>The <strong>winoptions</strong> file is used to configure settings for individual
application windows. Each line in this file must have one of the
following formats:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong>  window_name.window_class.option: argument</strong></p>
</li>
<li>
<p><strong>  window_name.window_role.option: argument</strong></p>
</li>
<li>
<p><strong>  window_class.option: argument</strong></p>
</li>
<li>
<p><strong>  window_name.option: argument</strong></p>
</li>
<li>
<p><strong>  window_role.option: argument</strong></p>
</li>
<li>
<p><strong>  .option: argument</strong></p>
</li>
</ul>
</div>
<div class="paragraph">
<p>The last format sets a default option value for all windows. Each
window on the desktop should have <strong>name</strong> and <strong>class</strong> resources
associated with it. Some applications also have a <strong>window role</strong>
resource. They can be determined using the <code>xprop</code> utility. When used
on a toplevel window, <code>xprop | grep -e CLASS -e ROLE</code> should output
a line like this:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>WM_CLASS = "name", "Class"</pre>
</div>
</div>
<div class="paragraph">
<p>and may also display a line like this:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>WM_WINDOW_ROLE = "window role"</pre>
</div>
</div>
<div class="paragraph">
<p>It&#8217;s possible that an application&#8217;s <strong>name</strong> and/or <strong>class</strong> contains
a dot character (<strong>.</strong>), which is also used by IceWM to separate
<strong>name</strong>, <strong>class</strong> and <strong>role</strong> values. In this case precede the dot
with the backslash character. In the following example, we suppose
an application&#8217;s window has <code>the.name</code> as its <strong>name</strong> value and
<code>The.Class</code> as its <strong>class</strong> value and for this combination we set
<strong>option</strong> to <strong>argument</strong>.</p>
</div>
<div class="literalblock">
<div class="content">
<pre>the\.name.The\.Class.option: argument</pre>
</div>
</div>
<div class="paragraph">
<p>Options that can be set per window are as follows:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong>icon</strong></p>
<div class="paragraph">
<p>The name of the icon.</p>
</div>
</li>
<li>
<p><strong>workspace</strong></p>
<div class="paragraph">
<p>Default workspace for window (number, counting from 0)</p>
</div>
</li>
<li>
<p><strong>layer</strong></p>
<div class="paragraph">
<p>The default stacking layer for the window. Layer can be one of the
following seven strings:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><em>Desktop</em>
Desktop window. There should be only one window in this layer.</p>
</li>
<li>
<p><em>Below</em>
Below default layer.</p>
</li>
<li>
<p><em>Normal</em>
Default layer for the windows.</p>
</li>
<li>
<p><em>OnTop</em>
Above the default.</p>
</li>
<li>
<p><em>Dock</em>
Layer for windows docked to the edge of the screen.</p>
</li>
<li>
<p><em>AboveDock</em>
Layer for the windows above the dock.</p>
</li>
<li>
<p><em>Menu</em>
Layer for the windows above the dock.</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>You can also use a number from 0 to 15.</p>
</div>
</li>
<li>
<p><strong>geometry</strong></p>
<div class="paragraph">
<p>The default geometry for the window. This geometry should be specified
in the usual X11-geometry-syntax, formal notation:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>[=][&lt;width&gt;{xX}&lt;height&gt;][{+-}&lt;xoffset&gt;{+-}&lt;yoffset&gt;]</pre>
</div>
</div>
</li>
<li>
<p><strong>tray</strong></p>
<div class="paragraph">
<p>The default tray option for the window. This affects both the tray
and the task pane. Tray can be one of the following strings:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><em>Ignore</em>
Don&#8217;t add an icon to the tray pane.</p>
</li>
<li>
<p><em>Minimized</em>
Add an icon the the tray. Remove the task pane button when minimized.</p>
</li>
<li>
<p><em>Exclusive</em>
Add an icon the the tray. Never create a task pane button.</p>
</li>
</ul>
</div>
</li>
<li>
<p><strong>order: 0</strong></p>
<div class="paragraph">
<p>The sorting order of task buttons and tray icons. The default value
is zero. Increasing positive values go farther right, while decreasing
negative values go farther left. The order option applies to the task
pane, the tray pane and the system tray.</p>
</div>
</li>
<li>
<p><strong>allWorkspaces: 0</strong></p>
<div class="paragraph">
<p>If set to 1, window will be visible on all workspaces.</p>
</div>
</li>
<li>
<p><strong>appTakesFocus: 0</strong></p>
<div class="paragraph">
<p>if set to 1, IceWM will assume the window supports the WM_TAKE_FOCUS
protocol even if the window did not advertise that it does.</p>
</div>
</li>
<li>
<p><strong>dBorder: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not have a border.</p>
</div>
</li>
<li>
<p><strong>dClose: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not have a close button.</p>
</div>
</li>
<li>
<p><strong>dMaximize: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not have a maximize button.</p>
</div>
</li>
<li>
<p><strong>dMinimize: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not have a minimize button.</p>
</div>
</li>
<li>
<p><strong>dResize: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not have a resize border.</p>
</div>
</li>
<li>
<p><strong>dSysMenu: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not have a system menu.</p>
</div>
</li>
<li>
<p><strong>dTitleBar: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not have a title bar.</p>
</div>
</li>
<li>
<p><strong>doNotCover: 0</strong></p>
<div class="paragraph">
<p>if set to 1, this window will limit the workspace available for
regular applications. At the moment the window has to be sticky to
make it work.</p>
</div>
</li>
<li>
<p><strong>doNotFocus: 0</strong></p>
<div class="paragraph">
<p>if set to 1, IceWM will never give focus to the window.</p>
</div>
</li>
<li>
<p><strong>fClose: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not be closable.</p>
</div>
</li>
<li>
<p><strong>fHide: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not be hidable.</p>
</div>
</li>
<li>
<p><strong>fMaximize: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not be maximizable.</p>
</div>
</li>
<li>
<p><strong>fMinimize: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not be minimizable.</p>
</div>
</li>
<li>
<p><strong>fMove: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not be movable.</p>
</div>
</li>
<li>
<p><strong>fResize: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not be resizable.</p>
</div>
</li>
<li>
<p><strong>fRollup: 1</strong></p>
<div class="paragraph">
<p>If set to 0, window will not be shadable.</p>
</div>
</li>
<li>
<p><strong>forcedClose: 0</strong></p>
<div class="paragraph">
<p>if set to 1 and the application had not registered WM_DELETE_WINDOW,
a close confirmation dialog won&#8217;t be offered upon closing the window.</p>
</div>
</li>
<li>
<p><strong>fullKeys: 0</strong></p>
<div class="paragraph">
<p>If set to 1, the window manager leave more keys (Alt+F?) to the
application.</p>
</div>
</li>
<li>
<p><strong>ignoreNoFocusHint: 0</strong></p>
<div class="paragraph">
<p>if set to 1, IceWM will focus even if the window does not handle input.</p>
</div>
</li>
<li>
<p><strong>ignorePagerPreview: 0</strong></p>
<div class="paragraph">
<p>If set to 1, window will not appear in pager preview.</p>
</div>
</li>
<li>
<p><strong>ignorePositionHint: 0</strong></p>
<div class="paragraph">
<p>if set to 1, IceWM will ignore the position hint.</p>
</div>
</li>
<li>
<p><strong>ignoreQuickSwitch: 0</strong></p>
<div class="paragraph">
<p>If set to 1, window will not be accessible using QuickSwitch feature
(Alt+Tab).</p>
</div>
</li>
<li>
<p><strong>ignoreTaskBar: 0</strong></p>
<div class="paragraph">
<p>If set to 1, window will not appear on the task bar.</p>
</div>
</li>
<li>
<p><strong>ignoreUrgentHint: 0</strong></p>
<div class="paragraph">
<p>if set to 1, IceWM will ignore it if the window sets the urgent hint.</p>
</div>
</li>
<li>
<p><strong>ignoreWinList: 0</strong></p>
<div class="paragraph">
<p>If set to 1, window will not appear in the window list.</p>
</div>
</li>
<li>
<p><strong>noFocusOnAppRaise: 0</strong></p>
<div class="paragraph">
<p>if set to 1, window will not automatically get focus as application
raises it.</p>
</div>
</li>
<li>
<p><strong>noFocusOnMap: 0</strong></p>
<div class="paragraph">
<p>if set to 1, IceWM will not assign focus when the window is mapped
for the first time.</p>
</div>
</li>
<li>
<p><strong>nonICCCMconfigureRequest: 0</strong></p>
<div class="paragraph">
<p>if set to 1, IceWM assumes the application does not support the ICCCM
standard wrt positioning and compensate for that.</p>
</div>
</li>
<li>
<p><strong>startFullscreen: 0</strong></p>
<div class="paragraph">
<p>if set to 1, window will cover the entire screen.</p>
</div>
</li>
<li>
<p><strong>startMaximized: 0</strong></p>
<div class="paragraph">
<p>if set to 1, window starts maximized.</p>
</div>
</li>
<li>
<p><strong>startMaximizedHorz: 0</strong></p>
<div class="paragraph">
<p>if set to 1, window starts maximized horizontally.</p>
</div>
</li>
<li>
<p><strong>startMaximizedVert: 0</strong></p>
<div class="paragraph">
<p>if set to 1, window starts maximized vertically.</p>
</div>
</li>
<li>
<p><strong>startMinimized: 0</strong></p>
<div class="paragraph">
<p>if set to 1, window starts minimized.</p>
</div>
</li>
</ul>
</div>
</div>
</div>
<div class="sect1">
<h2 id="icon-handling">Icon handling</h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="generic">Generic</h3>
<div class="paragraph">
<p>The window manager expects to find two XPM files for each icon
specified in the configuration files as <em>ICON</em>. They should be named
like this:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong>ICON_16x16.xpm</strong></p>
<div class="paragraph">
<p>A small 16x16 pixmap.</p>
</div>
</li>
<li>
<p><strong>ICON_32x32.xpm</strong></p>
<div class="paragraph">
<p>A normal 32x32 pixmap.</p>
</div>
</li>
<li>
<p><strong>ICON_48x48.xpm</strong></p>
<div class="paragraph">
<p>A large 48x48 pixmap.</p>
</div>
</li>
</ul>
</div>
<div class="paragraph">
<p>Other pixmap sizes like 20x20, 24x24, 40x40, 48x48, 64x64 might be
used in the future. Perhaps we need a file format that can contain
more than one image (with different sizes and color depths) like
Windows'95 and OS/2 .ICO files.</p>
</div>
<div class="paragraph">
<p>It would be nice to have a feature from OS/2 that varies the icon
size with screen resolution (16x16 and 32x32 icons are quite small
on 4000x4000 screens ;-)</p>
</div>
</div>
<div class="sect2">
<h3 id="gdk-pixbuf">GDK-Pixbuf</h3>
<div class="paragraph">
<p>When icewm was configured with the <code>--enable-gdk-pixbuf</code> option all
of GdkPixbuf&#8217;s image formats are supported. Use them by specifying
the full filename or an absolute path:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong>ICON.bmp</strong></p>
<div class="paragraph">
<p>A PPM icon in your IconPath.</p>
</div>
</li>
<li>
<p><strong>/usr/share/pixmap/ICON.png</strong></p>
<div class="paragraph">
<p>An PNG image with absolute location.</p>
</div>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="sect1">
<h2 id="mouse-cursors">Mouse cursors</h2>
<div class="sectionbody">
<div class="paragraph">
<p>IceWM scans the theme and configuration directories for a subdirectory
called <em>cursors</em> containing monochrome but transparent XPM files. To
change the mouse cursor you have to use this filenames:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><strong>left.xbm</strong></p>
<div class="paragraph">
<p>Default cursor (usually pointer to the left).</p>
</div>
</li>
<li>
<p><strong>right.xbm</strong></p>
<div class="paragraph">
<p>Menu cursor (usually pointer to the right).</p>
</div>
</li>
<li>
<p><strong>move.xbm</strong></p>
<div class="paragraph">
<p>Window movement cursor.</p>
</div>
</li>
<li>
<p><strong>sizeTL.xbm</strong></p>
<div class="paragraph">
<p>Cursor when you resize the window by top left.</p>
</div>
</li>
<li>
<p><strong>sizeT.xbm</strong></p>
<div class="paragraph">
<p>Cursor when you resize the window by top.</p>
</div>
</li>
<li>
<p><strong>sizeTR.xbm</strong></p>
<div class="paragraph">
<p>Cursor when you resize the window by top right.</p>
</div>
</li>
<li>
<p><strong>sizeL.xbm</strong></p>
<div class="paragraph">
<p>Cursor when you resize the window by left.</p>
</div>
</li>
<li>
<p><strong>sizeR.xbm</strong></p>
<div class="paragraph">
<p>Cursor when you resize the window by right.</p>
</div>
</li>
<li>
<p><strong>sizeBL.xbm</strong></p>
<div class="paragraph">
<p>Cursor when you resize the window by bottom left.</p>
</div>
</li>
<li>
<p><strong>sizeB.xbm</strong></p>
<div class="paragraph">
<p>Cursor when you resize the window by bottom.</p>
</div>
</li>
<li>
<p><strong>sizeBR.xbm</strong></p>
<div class="paragraph">
<p>Cursor when you resize the window by bottom right.</p>
</div>
</li>
</ul>
</div>
</div>
</div>
<div class="sect1">
<h2 id="themes">Themes</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Themes are used to configure the way the window manager looks. Things
like fonts, colors, border sizes, button pixmaps can be configured. Put
together they form a theme.</p>
</div>
<div class="paragraph">
<p>Theme files are searched in the <code>themes</code> subdirectories.</p>
</div>
<div class="paragraph">
<p>These directories contain other directories that contain related
theme files and their .xpm files. Each theme file specifies fonts,
colors, border sizes, &#8230;&#8203;</p>
</div>
<div class="paragraph">
<p>The theme to use is specified in <code>~/.icewm/theme</code> file:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>Theme = "nice/default.theme"</code></p>
<div class="paragraph">
<p>Name of the theme to use. Both the directory and theme file name must
be specified.</p>
</div>
</li>
</ul>
</div>
<div class="paragraph">
<p>If the theme directory contains a file named <em>fonts.dir</em> created by
mkfontdir the theme directory is inserted into the X servers font
search path.</p>
</div>
<div class="paragraph">
<p><a href="https://themes.ice-wm.org">www.box-look.org</a> has a very large number
of themes which were created by users of IceWM.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="command-line-options">Command Line Options</h2>
<div class="sectionbody">
<div class="paragraph">
<p><code>icewm</code> supports the following options:</p>
</div>
<div class="listingblock">
<div class="content">
<pre>-d, --display=NAME
NAME of the X server to use.

--client-id=ID
Client id to use when contacting session manager.

--sync
Synchronize X11 commands.

-c, --config=FILE
Load preferences from FILE.

-t, --theme=FILE
Load theme from FILE.

--postpreferences
Print preferences after all processing.

-V, --version
Prints version information and exits.

-h, --help
Prints this usage screen and exits.

--replace
Replace an existing window manager.

-r, --restart
Tell the running icewm to restart itself.

--configured
Print the compile time configuration.

--directories
Print the configuration directories.

-l, --list-themes
Print a list of all available themes.</pre>
</div>
</div>
<div class="paragraph">
<p>The restart option can be used to reload the IceWM configuration
after modifications. It is the preferred way to restart IceWM from
the command line or in scripts. To load a different theme from the
command line, combine this with the <code>--theme=NAME</code> option like:</p>
</div>
<div class="literalblock">
<div class="content">
<pre>icewm -r -t CrystalBlue</pre>
</div>
</div>
<div class="paragraph">
<p>The theme name will then be saved to the 'theme' configuration file,
before restarting IceWM.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="glossary">Glossary</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Resource Path
A set of directories used by IceWM to locate resources like
configuration files, themes, icons. See section <strong>The Resource Path</strong>.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="authors">Authors</h2>
<div class="sectionbody">
<div class="paragraph">
<p>Authors having contributed to this document include Gallium, Macek,
Hasselmann, Gijsbers, Bidulock and Bloch.</p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="see-also">See Also</h2>
<div class="sectionbody">
<div class="paragraph">
<p><a href="https://ice-wm.org/man/icehelp.html">icehelp(1)</a>,
<a href="https://ice-wm.org/man/icesh.html">icesh(1)</a>,
<a href="https://ice-wm.org/man/icesound.html">icesound(1)</a>,
<a href="https://ice-wm.org/man/icewm-env.html">icewm-env(5)</a>,
<a href="https://ice-wm.org/man/icewm-focus_mode.html">icewm-focus_mode(5)</a>,
<a href="https://ice-wm.org/man/icewm-keys.html">icewm-keys(5)</a>,
<a href="https://ice-wm.org/man/icewm-menu-fdo.html">icewm-menu-fdo(1)</a>,
<a href="https://ice-wm.org/man/icewm-menu.html">icewm-menu(5)</a>,
<a href="https://ice-wm.org/man/icewm-preferences.html">icewm-preferences(5)</a>,
<a href="https://ice-wm.org/man/icewm-prefoverride.html">icewm-prefoverride(5)</a>,
<a href="https://ice-wm.org/man/icewm-programs.html">icewm-programs(5)</a>,
<a href="https://ice-wm.org/man/icewm-session.html">icewm-session(1)</a>,
<a href="https://ice-wm.org/man/icewm-set-gnomewm.html">icewm-set-gnomewm(1)</a>,
<a href="https://ice-wm.org/man/icewm-shutdown.html">icewm-shutdown(5)</a>,
<a href="https://ice-wm.org/man/icewm-startup.html">icewm-startup(5)</a>,
<a href="https://ice-wm.org/man/icewm-theme.html">icewm-theme(5)</a>,
<a href="https://ice-wm.org/man/icewm-toolbar.html">icewm-toolbar(5)</a>,
<a href="https://ice-wm.org/man/icewm-winoptions.html">icewm-winoptions(5)</a>,
<a href="https://ice-wm.org/man/icewm.html">icewm(1)</a>,
<a href="https://ice-wm.org/man/icewmbg.html">icewmbg(1)</a>,
<a href="https://ice-wm.org/man/icewmhint.html">icewmhint(1)</a>,
<a href="https://ice-wm.org/man/icewmtray.html">icewmtray(1)</a>.</p>
</div>
</div>
</div>
</div>
<div id="footer">
<div id="footer-text">
Version 1.4.2<br>
Last updated 2019-04-23 21:59:41 CEST
</div>
</div>
</body>
</html>