|
NAMEicewm-winoptions - IceWM window options configuration file SYNOPSIS$ICEWM_PRIVCFG/winoptions $XDG_CONFIG_HOME/icewm/winoptions $HOME/.icewm/winoptions /usr/local/etc/icewm/winoptions /usr/local/share/icewm/winoptions DESCRIPTIONContains settings to control window appearance and behaviour. These are specific to applications, or to groups of applications. Options can control the window border, whether the application 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.Options are established when icewm(1) starts. However, they can be overridden later using icesh(1) or icewmhint(1). The command "icesh winoptions" instructs icewm to reload the winoptions file. FORMATEach line in the file must be in one of the following formats:
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. OPTIONSThe 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 OPTIONSThe following option control general characteristics of windows:
FUNCTION OPTIONSFunction 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 OPTIONSDecor 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 OPTIONSFeature 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. ignoreActivationMessages: {1|0} only user can focus window. noFocusOnAppRaise: {1|0} no focus on raise. noFocusOnMap: {1|0} do not focus when mapped. noIgnoreTaskBar: {1|0} on task bar. startClose: {1|0} close the window immediately. 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. EXAMPLESThis example uses the WM_WINDOW_ROLE property value "pop-up" to deny input focus to Chrome pop-ups and asks to close them immediately.google-chrome.pop-up.doNotFocus: 1 google-chrome.pop-up.forcedClose: 1 google-chrome.pop-up.ignorePagerPreview: 1 google-chrome.pop-up.ignoreUrgentHint: 1 google-chrome.pop-up.layer: Below google-chrome.pop-up.noFocusOnAppRaise: 1 google-chrome.pop-up.noFocusOnMap: 1 google-chrome.pop-up.startClose: 1 google-chrome.pop-up.startMinimized: 1 IceWM places dockapps in a container automatically, but for those which fail to comply with the protocol it can also be emulated. An emulated dockapp should appear on all workspaces, have no decorations, and always be visible in a fixed location. wmtime.wmtime.allWorkspaces: 1 wmtime.wmtime.ignoreTaskBar: 1 wmtime.wmtime.ignoreQuickSwitch: 1 wmtime.wmtime.ignoreWinList: 1 wmtime.wmtime.layer: Below wmtime.wmtime.dTitleBar: 0 wmtime.wmtime.dBorder: 1 wmtime.wmtime.geometry: 64x64-74-100 Following is the example window options file that ships with icewm(1) and typically installs to /usr/local/share/icewm/winoptions. # This is an example for IceWM's window options file. # # Place your variants in /usr/local/etc/icewm 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 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 FILESLocations for the winoptions file are as follows:$ICEWM_PRIVCFG/winoptions $XDG_CONFIG_HOME/icewm/winoptions $HOME/.icewm/winoptions /usr/local/etc/icewm/winoptions /usr/local/share/icewm/winoptions The locations are searched in the order listed; the first file found is read and the remainder ignored. SEE ALSOicewm(1), icesh(1), icewmhint(1), setxkbmap(1), XParseGeometry(3).AUTHORBrian Bidulock <mailto:bidulock@openss7.org>.LICENSEIceWM is licensed under the GNU Library General Public License. See the COPYING file in the distribution.
Visit the GSP FreeBSD Man Page Interface. |