evilwm usage

Skip to site navigation

Note: this page reflects the current pre-release. If you're using a previous version, consult the man page that came with it.

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 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 xterm.
Escape
Delete current window.
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.

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).
-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 -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.
-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.

Bugs

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

Updated 4 Oct 2009