WinCommand (1) AfterStep module for choosing and manipulating windows based on patterns

CONFIGURATION OPTIONS

DESCRIPTION

WinCommand is a command line tool which allows you to select windows based on their name and to then manipulate them in various ways. Actions currently supported are: "center", "center jump", "iconify", "jump", "kill", "move", "resize" and "sendtodesk".

DEFAULTS

The default pattern is "", meaning all windows will be selected.

All other default-values depend on the action you would like WinCommand to take. If more than one action is specified, default-values are set depending on the last action specified.

ACTIONS

center

Place matching windows into the center of the screen.

center jump:

Places first window that matches into the center of the screen and jumps to it.

iconify:

Iconifies matching windows.

jump:

Jumps to the first window which matches.

kill:

Kills all matching windows.

move:

Moves all matching windows to x/y. x and y are specified using the -x and -y flags.

resize:

Resize all matching windows. The two parameters width and height are specified using the -width and -height flags.

send_to_desk:

Send all matching windows to desk specified with the -new_desk flag.

OPTIONS

-all

Operate on all windows which match the given pattern. This is set by default unless the action is either "jump" or "center jump".

-alldesks

Windows on all desks will be taken into account. This is set by default if action is either "jump" or "center jump".

-desk

Windows on the whole desk will be taken into account.

-x/-y

These are required when issuing the move-command.

-width/-height

These are required whenever you want to resize windows.

Examples WinCommand -pattern term iconify

This command will iconify all terminals. Since the specified pattern is a regular expression, something like this also works:

WinCommand -pattern "(term)|(moz)" iconify

This will iconify all terminals and mozilla-browser windows.

WinCommand -pattern xmm jump

will jump to your xmms. In this situation, it's far more advisable to use GWCommand though.

It is probably not a good idea to delete windows while windows are being arranged.