man

IceWM man pages

View the Project on GitHub

NAME

icewmhint - set IceWM hints by window class and instance

SYNOPSIS

icewmhint CLASS.INSTANCE OPTION VALUE

DESCRIPTION

icewmhint is a utility for passing IceWM hints to icewm(1). icewm uses these hints for the first X11 client which is subsequently started. They take precedence over hints from the icewm-winoptions(1) file.

A hint is a triplet consisting of a class.instance, an IceWM winoption and its value. Multiple hints can be given per invocation of icewmhint.

The hints are communicated over the _ICEWM_WINOPTHINT property on the root window. icewmhint appends hints to this property, while icewm removes the property after reading it.

OPTIONS

icewmhint recognizes the following options:

COMMAND OPTIONS

Only one command option can be specified per invocation. If no command option is specified, argument parsing and processing is performed.

GENERAL OPTIONS

ARGUMENTS

The following three arguments are required for each hint.

Multiple hints can be given.

GENERAL OPTION ARGUMENTS

General option arguments are normally associated with GNOME WinWM/WMH hints (except for the tray option argument).

FUNCTION OPTION ARGUMENTS

Specifies which functions are disabled or enabled (0/1) for windows with CLASS.INSTANCE. All functions have a default value of enabled (1) unless overridden by the application. The Motif-like functions are as follows:

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

DECOR OPTION ARGUMENTS

Specifies which decorations are disabled or enabled (0/1) for windows with CLASS.INSTANCE. All decor options have a default value of enabled (1) unless overridden by the application. The Motif-like decorations are as follows:

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

FEATURE OPTION ARGUMENTS

Specifies which advanced features to be enabled/disabled (1/0) for windows with CLASS.INSTANCE. All advanced features have a default value of disabled (0) unless overridden by the application. The advanced features are as follows:

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

EXAMPLE

# Here is how to preload an invisible background process of chromium
# on the fourth workspace which is only visible on the Window List.

icewmhint Chromium-browser startMinimized 1 \
          Chromium-browser workspace 3 \
          Chromium-browser ignorePagerPreview 1 \
          Chromium-browser ignorePositionHint 1 \
          Chromium-browser ignoreTaskBar 1 \
          Chromium-browser ignoreQuickSwitch 1 \
          Chromium-browser ignoreUrgentHint 1 \
          Chromium-browser noFocusOnAppRaise 1
chromium

BUGS

icewmhint had no known bugs at the time of release. Please report bugs for current versions to the source code repository at Github.

AUTHOR

Brian Bidulock.

See –copying for full copyright notice and copying permissions.

LICENSE

IceWM is licensed under the GNU Library General Public License. See the COPYING file in the distribution or use the –copying flag to display copying permissions.

Index IceWM