evilwm usage

Controls

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 1Move window.
Button 2Resize window.
Button 3Lower window.

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

ReturnSpawn new xterm.
EscapeDelete current window.
InsertLower current window.
H, J, K, LMove window left, down, up or right (16 pixels). Holding Shift resizes the window instead.
Y, U, B, NMove window to top-left, top-right, bottom-left or bottom-right of screen.
IShow information about current window.
EqualsMaximise current window vertically (toggle).
XMaximise current window (toggle).

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

FFix or unfix current window.
1 - 8Switch virtual desktop.
LeftPrevious virtual desktop.
RightNext virtual desktop.

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

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).
-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 mousebutton 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 -g, -v and -s options will apply to this match.
-g geometry
apply a geometry (using a standard X geometry string) to applications matching the last -app.
-v vdesk
specify a default virtual desktop for applications matching the last -app.
-s
specify that application is to start with a sticky client window.
-nosoliddrag
draw a window outline while moving or resizing.
-V
print version number.

Bugs

See the Sourceforge bug-tracking page and the Debian Bug report logs.

Updated 20 Feb 2006