Descriptions

Overview

Certain bang commands refer to desktops, windows, and monitors, which are described by identifying some property, and in case nothing matches that property, a second choice, third choice, and so on. Choices are separated by slashes, so for example,

!sbDesk next/first

will switch to the next desk and wrap around to the first desk at the end, but

!sbDesk next/newnext

will switch to the next desk, but make a new desk rather than wrap around.

Desktops

Wherever a bang command or variable refers to a desktop, you may choose a desktop using one of the following descriptions. Note that there may not be such a desktop; for example, if the last desktop is selected, then "next" doesn't refer to anything. If no parameter is given or if none of the described desks exists, defaults to clicked/next/prev/current. The available descriptions are:

Windows

Whenever a bang command or variable refers to a window, you may choose a window using one of the following descriptions. (These descriptions are mainly to support mouse event handling and drag and drop).

If a task owns more than one window, then layout elements involving it will use the root window. Most bang commands (like !sbMoveApp) will affect the entire task, including all its child windows.

Monitors

Whenever a bang command or variable refers to a monitor, you may choose a monitor using one of the following descriptions. When a monitor is expected but none is specified, 'cursor' is used as the default.