man

IceWM man pages

View the Project on GitHub

NAME

icewm-winoptions - IceWM window options configuration file

SYNOPSIS

DESCRIPTION

The IceWM window options configuration file is used to configure settings for individual application windows. The window options that are established by this file when icewm(1) starts can be overridden while running using the icesh(1) or icewmhint(1) utilities.

Contains settings to control window appearance and behaviour which are specific to applications or groups of applications. Options can control the border, whether it appears on the task bar, the window list, the system tray and the work spaces. Also its layer, geometry, whether it can be moved, resized and closed. Full details for this file are explained in the IceWM Manual.

FORMAT

Each line in the file must be in one of the following formats:

  • NAME.CLASS.ROLE.OPTION: VALUE
  • NAME.CLASS.OPTION: VALUE
  • CLASS.ROLE.OPTION: VALUE
  • NAME.ROLE.OPTION: VALUE
  • CLASS.OPTION: VALUE
  • NAME.OPTION: VALUE
  • ROLE.OPTION: VALUE

Where the fields are defined as follows:

Note that it is possible that the WM_WINDOW_ROLE may contain a period (.). When it does, the period should be escaped by a single backslash when specifying the ROLE in the file.

OPTIONS

The options and values described in the format, above, consist of an option name, OPTION followed by a semicolon (:) a space ( ) and an allowable value for the option, VALUE. The available options are as follows:

GENERAL OPTIONS

The following option control general characteristics of windows:

FUNCTION OPTIONS

Function options enable/disable (1/0) the ability to take an action on the window. The normal default for all options is enabled (1) unless overridden by the application. The following options are defined:

fClose:    {0\|1}  can be closed.        (default: 1)
fHide:     {0\|1}  can be hidden.        (default: 1)
fMaximize: {0\|1}  can be maximized.     (default: 1)
fMinimize: {0\|1}  can be minimized.     (default: 1)
fMove:     {0\|1}  can be moved.         (default: 1)
fResize:   {0\|1}  can be resized.       (default: 1)
fRollup:   {0\|1}  can be shaded.        (default: 1)

DECOR OPTIONS

Decor options enable/disable (1/0) decorations on the window. The normal default for all options is enabled (1) unless overridden by the application. The following options are defined:

dBorder:   {0\|1}  has border.           (default: 1)
dClose:    {0\|1}  has close button.     (default: 1)
dDepth:    {0\|1}  has depth button.     (default: 1)
dHide:     {0\|1}  has hide button.      (default: 1)
dMaximize: {0\|1}  has maximize button.  (default: 1)
dMinimize: {0\|1}  has minimize button.  (default: 1)
dResize:   {0\|1}  has resize grips.     (default: 1)
dRollup:   {0\|1}  has shade button.     (default: 1)
dSysMenu:  {0\|1}  has window menu.      (default: 1)
dTitleBar: {0\|1}  has title bar.        (default: 1)

FEATURE OPTIONS

Feature options enable/disable (1/0) additional features of the window. The normal default for all options is disabled (0) unless overridden by the application. The following options are defined:

allWorkspaces:            {1\|0}  on all workspaces.
appTakesFocus:            {1\|0}  let application take focus.
doNotCover:               {1\|0}  limits workspace if sticky.
doNotFocus:               {1\|0}  do not focus.
forcedClose:              {1\|0}  no close dialog.
fullKeys:                 {1\|0}  provided more keys.
ignoreNoFocusHint:        {1\|0}  focus even no-input.
ignorePagerPreview:       {1\|0}  do not show in pager preview.
ignorePositionHint:       {1\|0}  place automatically.
ignoreQuickSwitch:        {1\|0}  not on quick switch.
ignoreTaskBar:            {1\|0}  not on task bar.
ignoreUrgentHint:         {1\|0}  ignore urgent hints.
ignoreWinList:            {1\|0}  not on window list.
noFocusOnAppRaise:        {1\|0}  no focus on raise.
noFocusOnMap:             {1\|0}  do not focus when mapped.
noIgnoreTaskBar:          {1\|0}  on task bar.
nonICCCMconfigureRequest: {1\|0}  more configure requests.
startFullscreen:          {1\|0}  start full screen.
startMaximized:           {1\|0}  start maximized.
startMaximizedHorz:       {1\|0}  start maximized horizontal.
startMaximizedVert:       {1\|0}  start maximized vertical.
startMinimized:           {1\|0}  start minimized.

EXAMPLES

Following is the example window options file that ships with icewm(1) and typically installs to /usr/share/icewm/winoptions.

# This is an example for IceWM's window options file.
#
# Place your variants in @CFGDIR@ or in $HOME/.icewm
# since modifications to this file will be discarded when you
# (re)install icewm.

xterm.icon: xterm
rxvt.icon: xterm
nxterm.icon: xterm
fte.icon: fte
emacs.Emacs.icon: emacs
AWTapp.icon: java
# workaround for XV window repositioning problems
xv.nonICCCMconfigureRequest: 1
xeyes.ignoreWinList: 0
xeyes.ignoreTaskBar: 1
xeyes.allWorkspaces: 1
xeyes.dTitleBar: 0
xeyes.dBorder: 0
xeyes.dSysMenu: 0
xeyes.dResize: 0
xeyes.dClose: 0
xeyes.dMinimize: 0
xeyes.dMaximize: 0
xeyes.ignoreNoFocusHint: 1

XClock.ignoreNoFocusHint: 1
Vim.icon: vim

applix.ignoreNoFocusHint: 1
XDdts.noFocusOnAppRaise: 1
Wingz.noFocusOnAppRaise: 1
WingzPro.noFocusOnAppRaise: 1

gkrellm.Gkrellm.allWorkspaces: 1
gkrellm.Gkrellm.ignoreTaskBar: 1
gkrellm.Gkrellm.layer: Below
#gkrellm.Gkrellm.doNotCover: 1

MainWindow.licq.allWorkspaces: 1
MainWindow.licq.ignoreQuickSwitch: 1
MainWindow.licq.ignoreWinList: 1
MainWindow.licq.layer: Below
#MainWindow.licq.doNotCover: 1

FILES

Locations for the window options file are as follows:

SEE ALSO

icewm(1), icesh(1), icewmhint(1), XParseGeometry(3).

AUTHOR

Brian Bidulock.

LICENSE

IceWM is licensed under the GNU Library General Public License. See the COPYING file in the distribution.

Index IceWM