unexist.dev

h1. Clients

{{>toc}}

[[Clients]] Clients\015\012\015\012{{>toc}}\015\012\015\012[[Clients]] are the actual toplevel windows [[subtle]] manages.

h2. Types

There manages.\015\012\015\012h2. Types\015\012\015\012There are several different window types that set some of the [[Clients#Modes|client modes]] automatically, this can be used in [[tagging]] to mimic this behavior.

Following behavior.\015\012\015\012Following types exist:

h3. Normal

This exist:\015\012\015\012h3. Normal\015\012\015\012This is the default type of windows and no special modes are set for this.

h3. Desktop

Desktop this.\015\012\015\012h3. Desktop\015\012\015\012Desktop type windows are usually file managers that display icons and stay at the bottom of the window stack. They have no window title, no border and can neither be resized nor moved.

*Used moved.\015\012\015\012*Used modes*: [[Clients#Borderless|Borderless]], [[Clients#Fixed|Fixed]], [[Clients#Fullscreen|Fullscreen]]

h3. Dock

Dock [[Clients#Fullscreen|Fullscreen]]\015\012\015\012h3. Dock\015\012\015\012Dock type windows are usually panels that provide different kind of information and accessibility.

{{subforge_info(Currently accessibility.\015\012\015\012{{info(Currently there is no special handling of this window type.)}}

h3. Toolbar

Toolbar type.)}}\015\012\015\012h3. Toolbar\015\012\015\012Toolbar windows are usually windows with either text or icons menu entries.

{{subforge_info(Currently entries.\015\012\015\012{{info(Currently there is no special handling of this window type.)}}

h3. Splash

Splash type.)}}\015\012\015\012h3. Splash\015\012\015\012Splash windows are usually silly progress windows that are a placeholder until an app is ready.

*Used ready.\015\012\015\012*Used modes*: [[Clients#Center|Center]], [[Clients#Float|Float]]

h3. Dialog

Dialog [[Clients#Float|Float]]\015\012\015\012h3. Dialog\015\012\015\012Dialog windows are usually any kind of setting or message windows

*Used windows\015\012\015\012*Used modes*: [[Clients#Center|Center]], [[Clients#Float|Float]]

h2. Properties

[[Clients]] [[Clients#Float|Float]]\015\012\015\012h2. Properties\015\012\015\012[[Clients]] have different properties, called atoms in "Xorg":http://www.x.org/wiki/-speak, to e.g. identify the window or to communicate with other programs and the window manager. The typical way to list them is to use the program "xprop":http://www.google.de/search?sourceid=chrome&ie=UTF-8&q=xprop, which used to be part of the "Xorg":http://www.x.org/wiki/ install, but might be broken into a separate package dependent on your distribution. Just start "xprop":http://www.google.de/search?sourceid=chrome&ie=UTF-8&q=xprop and click on a window, but be aware that the output is quite messy.

The messy.\015\012\015\012The instance and the class name are also included in the output of @subtler -cl@.

h3. WM_NAME

This -cl@.\015\012\015\012h3. WM_NAME\015\012\015\012This property is used as the window title of the [[Clients|client]].

Example:

<pre><code>$ [[Clients|client]].\015\012\015\012Example:\015\012\015\012<pre><code>$ xprop | grep WM_NAME
_NET_WM_NAME(UTF8_STRING) WM_NAME\015\012_NET_WM_NAME(UTF8_STRING) = "tmux:xprop3"
WM_NAME(STRING) "tmux:xprop3"\015\012WM_NAME(STRING) = "tmux:xprop3"</code></pre>

{{subforge_info(When "tmux:xprop3"</code></pre>\015\012\015\012{{info(When there are multiple values like in the example, [[subtle]] prefers the UTF8_STRING.)}}

h3. WM_CLASS

This UTF8_STRING.)}}\015\012\015\012h3. WM_CLASS\015\012\015\012This property consists of two strings: The instance name and the class name. They are mainly used to identify the window instance and to find resources in the resource files like @.Xdefaults@. The instance name can typically be customized by passing something like *-name name* to the app like for most of the terminals.

Example:

<pre><code>$ terminals.\015\012\015\012Example:\015\012\015\012<pre><code>$ xprop | grep WM_CLASS
WM_CLASS(STRING) WM_CLASS\015\012WM_CLASS(STRING) = "urxvt", "URxvt"</code></pre>

h3. WM_ROLE

This "URxvt"</code></pre>\015\012\015\012h3. WM_ROLE\015\012\015\012This property is *sometimes* used to identify the purpose of the window, like a browser or something else in the context of the program, but don't expect useful or consistent values.

Example:

<pre><code>$ values.\015\012\015\012Example:\015\012\015\012<pre><code>$ xprop | grep WM_ROLE
WM_ROLE(STRING) WM_ROLE\015\012WM_ROLE(STRING) = "browser"</code></pre>

h2. Modes

A "browser"</code></pre>\015\012\015\012h2. Modes\015\012\015\012A [[Clients|window]] can have different modes that influence the appearance and behavior of it either globally or just for [[Tagging|tagged]] [[views]]. [[subtle]] and [[subtler]] indicate this mode with a special character.

Following character.\015\012\015\012Following modes exist:

h3. Global

h4. Borderless

This exist:\015\012\015\012h3. Global\015\012\015\012h4. Borderless\015\012\015\012This mode disables the [[Clients|window]] border of the [[Clients|window]] and uses the additional space for the [[Clients|window]].

h4. Fixed

This [[Clients|window]].\015\012\015\012h4. Fixed\015\012\015\012This mode prevents the window from being resized, that means that all actions (like [[Clients#Fullscreen|fullscreen]] and [[gravity]]) that would change the size are ignored.

{{subforge_info(This ignored.\015\012\015\012{{info(This mode is indicated by a *&#33;*.)}}

h4. Resize

This *&#33;*.)}}\015\012\015\012h4. Resize\015\012\015\012This mode enables the honoring of size hints, that are hints for the window manager about special size preferences and constraints like an aspect ratio.

{{subforge_info(This ratio.\015\012\015\012{{info(This mode is indicated by a *&#126;*.)}}

h4. Sticky

This *&#126;*.)}}\015\012\015\012h4. Sticky\015\012\015\012This mode overrides the [[Tagging|tagging]] and makes the [[Clients|window]] visible on all [[views]] on the same [[Multihead|screen]]. When a window isn't normally visible on a certain [[Views|view]] the current [[gravity]] instead of the default [[gravity]] will be used.

{{subforge_info(This used.\015\012\015\012{{info(This mode is indicated by a *&#42;*.)}}

h4. Zaphod

This *&#42;*.)}}\015\012\015\012h4. Zaphod\015\012\015\012This mode spans a window across all [[Multihead|screens]] regardless if the [[Clients|window]] is normally visible there.

{{subforge_info(This there.\015\012\015\012{{info(This mode is indicated by a *&#61;*.)}}

h3. *&#61;*.)}}\015\012\015\012h3. Per view

h4. Floating

This view\015\012\015\012h4. Floating\015\012\015\012This mode looses the window from the [[gravity]] grid and raises it above other windows. Size hints are automatically honored in floating mode and [[Clients|windows]] can be moved and resized. (Doing that with [[Gravity|gravitated]] windows enables floating mode)

{{subforge_info(This mode)\015\012\015\012{{info(This mode is indicated by a *&#94;*.)}}

h4. Fullscreen

This *&#94;*.)}}\015\012\015\012h4. Fullscreen\015\012\015\012This mode let's a [[Clients|window]] use the total space of [[Multihead|screen]], that includes all space that is normally used for [[Panel|panels]] and strut.

{{subforge_info(This strut.\015\012\015\012{{info(This mode is indicated by a *&#43;*.)}}

h4. Urgent

This *&#43;*.)}}\015\012\015\012h4. Urgent\015\012\015\012This mode automatically draws pointer and keyboard focus and highlights the [[Panel#Title|panel title]] and any [[view]]. Once the [[Clients|window]] gets focus this mode is removed.

h2. Stacking

There removed.\015\012\015\012h2. Stacking\015\012\015\012There are four stacking layers, ordered from top to bottom:

# [[Clients#Fullscreen|Fullscreen]]
# [[Clients#Floating|Floating]]
# [[Gravity]]
# bottom:\015\012\015\012# [[Clients#Fullscreen|Fullscreen]]\015\012# [[Clients#Floating|Floating]]\015\012# [[Gravity]]\015\012# [[Clients#Desktop|Desktop type]]

{{subforge_info(Lower/raise type]]\015\012\015\012{{info(Lower/raise just move the windows on their layer, for example [[Clients#Floating|floating]] [[Clients|windows]] cannot be below a [[gravity]] [[Clients|window]].)}}