Provided by: wmctrl_1.07-6_i386 bug

NAME

       wmctrl - interact with a EWMH/NetWM compatible X Window Manager.

SYNOPSIS

       wmctrl [ options | actions ]...

DESCRIPTION

       wmctrl  is  a  command  that  can  be used to interact with an X Window
       manager that is compatible with the EWMH/NetWM  specification.   wmctrl
       can  query  the window manager for information, and it can request that
       certain window management actions be taken.

       wmctrl is controlled  entirely  by  its  command  line  arguments.  The
       command  line  arguments are used to specify the action to be performed
       (with options that modify behavior) and any  arguments  that  might  be
       needed to perform the actions.

       The  following  sections  define  the  supported  actions  and options.
       Arguments to the actions and options are written in the form  <ARGNAME>
       in  the  descriptions  below. The detailed syntax for writing arguments
       are in a single section dedicated to that purpose.

ACTIONS

       The following command line arguments  can  be  specified  to  invoke  a
       wmctrl  action.  Only one action can be executed with the invocation of
       the wmctrl command.

       -a <WIN>
              Switch to the desktop containing the  window  <WIN>,  raise  the
              window, and give it focus.

       -b  ( add | remove | toggle),prop1 [,prop2 ]
              Add,   remove,   or   toggle   up   to   two  window  properties
              simultaneously. The  window  that  is  being  modified  must  be
              identified  with  a -r action. The property change is achived by
              using the EWMH _NET_WM_STATE  request.  The  supported  property
              names  (for  prop1 and prop2) are modal, sticky, maximized_vert,
              maximized_horz,  shaded,   skip_taskbar,   skip_pager,   hidden,
              fullscreen,  above  and  below.  Two properties are supported to
              allow operations like maximizing a window to full  screen  mode.
              Note  that  this  action is made up of exactly two shell command
              line arguments.

       -c <WIN>
              Close the window <WIN> gracefully.

       -d     List all desktops managed by the window  manager.  One  line  is
              output  for  each  desktop,  with  the line broken up into space
              separated columns. The first column contains an integer  desktop
              number.  The  second  column  contains  a  '*' character for the
              current desktop, otherwise it contains a '-' character. The next
              two  columns  contain  the fixed string DG: and then the desktop
              geometry as '<width>x<height>' (e.g. '1280x1024'). The following
              two  columns  contain the fixed string VP: and then the viewport
              position in the format '<y>,<y>' (e.g. '0,0').  The  next  three
              columns  after  this  contains the fixed string WA: and then two
              columns with the workarea geometry as 'X,Y and WxH'  (e.g.  '0,0
              1280x998').  The  rest  of  the  line  contains  the name of the
              desktop (possibly containing multiple spaces).

       -e <MVARG>
              Resize and move a window that  has  been  specified  with  a  -r
              action according to the <MVARG> argument.

       -g w,h Change  the geometry (common size) of all desktops so they are w
              pixels wide and  h  pixels  high.  w  and  h  must  be  positive
              integers. A window manager may ignore this request.

       -h     Print help text about program usage.

       -I name
              Set  the icon name (short title) of the window specified by a -r
              action to name.

       -k  ( on  |  off  )
              Turn on or off the window manager's "show the desktop" mode  (if
              the window manager implements this feature).

       -l     List  the  windows being managed by the window manager. One line
              is output for each window, with the line broken  up  into  space
              separated  columns.  The first column always contains the window
              identity as a hexadecimal integer, and the second column  always
              contains  the  desktop number (a -1 is used to identify a sticky
              window). If the -p option is  specified  the  next  column  will
              contain  the  PID for the window as a decimal integer. If the -G
              option is specified then four integer columns  will  follow:  x-
              offset,  y-offset,  width  and  height.  The  next column always
              contains the client machine name.  The  remainder  of  the  line
              contains  the window title (possibly with multiple spaces in the
              title).

       -m     Display  information  about   the   window   manager   and   the
              environment.

       -n N   Change the number of desktops to N (a non-negative integer).

       -N name
              Set the name (long title) of the window specified by a -r action
              to name.

       -o x,y Change the viewport for the current desktop. The values x and  y
              are  numeric  offsets  that specify the position of the top left
              corner of  the  viewport.  A  window  manager  may  ignore  this
              request.

       -r <WIN>
              Specify a target window for an action.

       -R <WIN>
              Move  the window <WIN> to the current desktop, raise the window,
              and give it focus.

       -s <DESK>
              Switch to the desktop <DESK>.

       -t <DESK>
              Move a window that has been specified with the -r action to  the
              desktop <DESK>.

       -T name
              Set  the  both the name (long title) and icon name (short title)
              of the window specified by a -r action to name.  This action  is
              like  using  the -N and -I actions at the same time (which would
              otherwise be impossible since wmctrl can execute only one action
              at a time).

OPTIONS

       The  following  options  modify the default actions, or they modify the
       interpretation of arguments.

       -F     Window name arguments (<WIN>) are to be treated as exact  window
              titles  that  are  case  sensitive.  Without this options window
              titles are considered to be case insensitive substrings  of  the
              full window title.

       -G     Include geometry information in the output of the -l action.

       -i     Interpret  window  arguments  (<WIN>)  as a numeric value rather
              than a string name for the window. If the numeric  value  starts
              with the prefix '0x' it is assumed to be a hexadecimal number.

       -p     Include PIDs in the window list printed by the -l action. Prints
              a PID of '0' if the  application  owning  the  window  does  not
              support it.

       -u     Override auto-detection and force UTF-8 mode.

       -v     Provide  verbose  output.  This  is really useful when debugging
              wmctrl itself.

       -w [ <WORKAROUND>[,<WORKAROUND>]... ]
              Use workarounds specified in the argument.

       -x     Include WM_CLASS in the window list or interpret  <WIN>  as  the
              WM_CLASS name.

ARGUMENTS

       <DESK> A Desktop is always specified by an integer which represents the
              desktop numbers. Desktop numbers start at 0.

       <MVARG>
              A move and resize argument has the format 'g,x,y,w,h'.  All five
              components  are  integers. The first value, g, is the gravity of
              the window, with 0 being the  most  common  value  (the  default
              value  for  the  window).  Please see the EWMH specification for
              other values.

              The four remaining values are a standard geometry specification:
              x,y  is  the  position of the top left corner of the window, and
              w,h is the width and height of the window,  with  the  exception
              that the value of -1 in any position is interpreted to mean that
              the current geometry value should not be modified.

       <WIN>  This argument specifies a  window  that  is  the  target  of  an
              action.  By default the argument is treated as if were a string,
              and windows are examined until one is found  with  a  title  the
              contains  the  specified  string  as  a substring. The substring
              matching is done in a case insensitive manner. The -F option may
              be  used  to  force  exact,  case  sensitive title matching. The
              option -i may be used  to  interpret  the  window  target  as  a
              numeric window identity instead of a string.

              The  window  name  string :SELECT: is treated specially. If this
              window name is used then wmctrl waits for the user to select the
              target window by clicking on it.

              The  window  name string :ACTIVE: may be used to instruct wmctrl
              to use the currently active window for the action.

       <WORKAROUND>
              There is only  one  work  around  currently  implemeted.  It  is
              specified by using the string DESKTOP_TITLES_INVALID_UTF8 and it
              causes the printing of non-ASCII desktop  tiles  correctly  when
              using Window Maker.

EXAMPLES

       Getting a list of windows managed by the window manager

              wmctrl -l

       Getting a list of windows with PID and geometry information.

              wmctrl -p -G -l

       Going to the window with a name containing 'emacs' in it

              wmctrl -a emacs

       Shade a window with a title that contains the word 'mozilla'

              wmctrl -r mozilla -b add,shaded

       Close a very specifically titled window sticky

              wmctrl -F -c 'Debian bug tracking system - Mozilla'

       Toggle the 'stickiness' of a window with a specific window identity

              wmctrl -i -r 0x0120002 -b add,sticky

       Change  the title of window to a specified string but choose the window
       by clicking on it

              wmctrl -r :SELECT: -T "Selected Window"

SEE ALSO

       zenity(1) is a useful dialog program for building scripts with wmctrl.

       Some examples of EWMH/NetWM compatible window managers  include  recent
       versions of Enlightenment, Icewm, Kwin, Sawfish and Xfce.

AUTHOR

       wmctrl was written by Tomas Styblo <tripie@cpan.org>.

       This manual page was written by Shyamal Prasad <shyamal@member.fsf.org>
       for the Debian project (but may be used by others).

                               December 12, 2004                     WMCTRL(1)