NAME

       evilwm - Minimalist Window Manager for X

SYNOPSIS

       evilwm  [  -display  display ] [ -term termprog ] [ -fn fontname ] [ -fg foreground-colour ] [ -fc fixed-
       colour ] [ -bg background-colour ] [ -bw borderwidth ] [ -snap num  ]  [  -mask1  modifiers  ]  [  -mask2
       modifiers ] [ -altmask modifier ] [ [ -app name/class ] [ -geometry geometry ] [ -dock ] [ -vdesk vdesk ]
       [ -fixed ] ]...  [ -nosoliddrag ] [ -V ]

DESCRIPTION

       evilwm  is  a  minimalist  window  manager based on aewm, extended to feature many keyboard controls, and
       otherwise altered to be more friendly.

       In evilwm, the focus follows the mouse pointer, and focus is not lost if you stray onto the root  window.
       The current window border is shaded gold, with other windows left as a dark grey.

       You  can  use  the mouse to manipulate windows either by click/dragging the 1 pixel border, or by holding
       down Alt and doing so anywhere in the client window. The controls are:

       Button 1
              Move window.

       Button 2
              Resize window.

       Button 3
              Lower window.

       Most keyboard controls are used by holding down Control and Alt, then pressing a key. Available functions
       are:

       Return Spawn new terminal.

       Escape Delete current window.  Hold Shift as well to force kill a client.

       Insert Lower current window.

       H, J, K, L
              Move window left, down, up or right (16 pixels).  Holding Shift resizes the window instead.

       Y, U, B, N
              Move window to top-left, top-right, bottom-left or bottom-right of screen.

       I      Show information about current window.

       Equals Maximise current window vertically (toggle).

       X      Maximise current window (toggle).

       D      Toggle visible state of docks (e.g., pagers and launch bars).

       If compiled with virtual desktop support, these functions are also available:

       F      Fix or unfix current window.

       1--8   Switch virtual desktop.

       Left   Previous virtual desktop.

       Right  Next virtual desktop.

       A      Switch to the most recently unmapped virtual desktop.

       In addition to the above, Alt+Tab can be used to cycle through windows on screen.

       To make evilwm exit, you have to kill the process.

OPTIONS

       -display display
              specifies the X display to run on.

       -term termprog
              specifies an alternative program to run when spawning  a  new  terminal  (defaults  to  xterm,  or
              x-terminal-emulator  in Debian).  Separate arguments with whitespace, and escape needed whitespace
              with a backslash.  Remember that special characters will also need to be protected from the shell.

       -fn fontname
              specify a font to use when resizing or displaying window titles.

       -fg foreground-colour
              frame colour of currently active window.

       -fc fixed-colour
              frame colour of active fixed windows.

       -bg background-colour
              frame colour of inactive windows.

       -bw borderwidth
              width of window borders in pixels.

       -snap num
              enable snap-to-border support.  num gives the proximity in pixels to snap to.

       -mask1 modifiers, -mask2 modifiers, -altmask modifier
              override the default keyboard modifiers used to grab keys for window manager functionality.  mask1
              is used for most keyboard controls (default: control+alt), and mask2  is  used  for  mouse  button
              controls  and  cycling windows (default: alt).  altmask is used to modify the behaviour of certain
              controls (default: shift).  Modifiers may be separated with + signs.  Valid modifiers  are  shift,
              lock, control, alt, mod1, mod2, mod3, mod4, mod5.

       -app name/class
              match  an application by instance name and class (for help in finding these, use the xprop tool to
              extract the WM_CLASS property).  Subsequent -geometry, -dock, -vdesk and -fixed options will apply
              to this match.

       -g, -geometry geometry
              apply a geometry (using a standard X geometry string) to applications matching the last -app.

       -dock  specify that application should be considered to be a dock,  even  if  it  lacks  the  appropriate
              property.

       -v, -vdesk vdesk
              specify a default virtual desktop for applications matching the last -app.  Note that desktops are
              numbered from 0.

       -f, -fixed
              specify  that  application  is  to  start  with  a  fixed client window (-s is also accepted to be
              compatible with previous versions).

       -nosoliddrag
              draw a window outline while moving or resizing.

       -V     print version number.

       evilwm will also read options, one per line, from a file called .evilwmrc in the user's  home  directory.
       Options  listed  in  a configuration file should omit the leading dash.  Options specified on the command
       line override those found in the configuration file.

FILES

       $HOME/.evilwmrc

BUGS

       The author's idea of friendly may differ to that of many other people.

AUTHOR

       Ciaran Anscomb <evilwm@6809.org.uk>.
       aewm was written by Decklin Foster <fosterd@hartwick.edu>.
       9wm was written by David Hogan <dhog@cs.su.oz.au>.

SEE ALSO

       xterm(1), xprop(1)

                                                October 13, 2010                                       evilwm(1)