NAME

       evilwm—minimalist window manager for X11

SYNOPSIS

       evilwm [OPTION]…

DESCRIPTION

       evilwm is a minimalist window manager for the X Window System. It features plenty of mouse
       and keyboard controls while providing a clean display, uncluttered by less  useful  window
       furniture (like title bars).

OPTIONS

       -display display
              specifies  the  X  display to run on. Usually this can be inferred from the DISPLAY
              environment variable.

       -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 colour, -fc colour, -bg colour
              frame  colour of currently active, fixed active, and inactive windows respectively.
              Either specify an X11 colour name like goldenrod, or a hex triplet like #DAA520.

       -bw borderwidth
              width of window borders in pixels.

       -snap distance
              enable snap-to-border support. distance is the proximity in pixels to snap to.

       -wholescreen
              ignore monitor geometry and use the  whole  screen  dimensions.  This  is  the  old
              behaviour  from  before  multi-monitor  support  was  implemented, and may still be
              useful, e.g., when one large monitor is driven from multiple outputs.

       -numvdesks value
              number of virtual desktops to provide. Defaults to  8.  Any  extras  will  only  be
              accessible by pagers or using Control+Alt+(Left/Right).

       -nosoliddrag
              draw a window outline while moving or resizing.

       -mask1 modifiers, -mask2 modifiers, -altmask modifiers
              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 virtual desktops are numbered from zero.

       -f, -fixed
              specify that application is to start with a fixed client window.

       -help  show help

       -V     show program version

       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.

USAGE

       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 (unless it is fixed, in which
       case blue), with other windows left as a dark grey.

       You can use the mouse to manipulate windows  either  by  click/dragging  the  single-pixel
       border  (easier  when  they align with a screen edge), or by holding down Alt and doing so
       anywhere in the 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 the top-left, top-right, bottom-left or bottom-right of the  current
              monitor.

       I      Show information about current window.

       Equals Maximise  current  window  vertically  on  current  monitor (toggle). Holding Shift
              toggles horizontal maximization.

       X      Maximise current window to current monitor (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. Fixed windows remain visible when you  switch  virtual
              desktop.

       1—8    Switch to specific virtual desktop (internally, desktops are numbered from zero, so
              this actually switches to desktops 0—7; this only  becomes  important  if  you  use
              application matching).

       Left   Switch to next lower numbered virtual desktop.

       Right  Switch to next higher numbered virtual desktop.

       A      Switch to the previously selected virtual desktop.

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

       To make evilwm exit, kill the process.

FILES

       $HOME/.evilwmrc

BUGS

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

LICENCE

       Copyright (C) 1999-2021 Ciaran Anscomb <evilwm@6809.org.uk>

       This is free software. You can do what you want to it, but if it breaks something, you get
       to pay for the counselling. The code was originally based on aewm, so this is  distributed
       under the same terms, which follow.

AEWM LICENCE

       Copyright (c) 1998-2000 Decklin Foster.

       THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS", WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES
       OF ANY KIND. IN NO EVENT SHALL THE AUTHOR BE HELD LIABLE FOR ANY  DAMAGES  CONNECTED  WITH
       THE USE OF THIS PROGRAM.

       You  are  granted  permission  to  copy,  publish,  distribute, and/or sell copies of this
       program and any modified versions or derived  works,  provided  that  this  copyright  and
       notice are not removed or altered.

       Portions of the code were based on 9wm, which contains this license:

              9wm is free software, and is Copyright (c) 1994 by David Hogan.
              Permission is granted to all sentient beings to use this
              software, to make copies of it, and to distribute those copies,
              provided that:
                (1) the copyright and licence notices are left intact
                (2) the recipients are aware that it is free software
                (3) any unapproved changes in functionality are either
                      (i) only distributed as patches
                  or (ii) distributed as a new program which is not called 9wm
                          and whose documentation gives credit where it is due
                (4) the author is not held responsible for any defects
                    or shortcomings in the software, or damages caused by it.
              There is no warranty for this software.  Have a nice day.

SEE ALSO

       xterm (1), xprop (1)