.\" t
.\" @(#)WinCommand.1		03/24/2024
.TH WinCommand 1x "AfterStep v.2.2.12" "Mar 24 2024" "AfterStep X11 window manager"
.UC
.SH NAME
\fBWinCommand\fP\ \- AfterStep module for choosing and manipulating windows based on patterns



.SH CONFIGURATION OPTIONS

.SH 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"\&.

.SH 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\&.

.SH ACTIONS

.IP "center"

Place matching windows into the center of the screen\&.



.IP "center jump:"

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



.IP "iconify:"

Iconifies matching windows\&.



.IP "jump:"

Jumps to the first window which matches\&.



.IP "kill:"

Kills all matching windows\&.



.IP "move:"

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



.IP "resize:"

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



.IP "send_to_desk:"

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


.SH OPTIONS

.IP "\-all"

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



.IP "\-alldesks"

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



.IP "\-desk"

Windows on the whole desk will be taken into account\&.



.IP "\-x/\-y"

These are required when issuing the move\-command\&.



.IP "\-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\&.