evilwm - Minimalist Window Manager for X

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

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.

Insert

Lower current window.

H, J, K, L

Move window left, down, up or right (16 pixels).

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

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.

-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

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). 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 xlsclients tool with the -l option). Subsequent -g, -s and -v 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.

-V

print version number.

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

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

xterm(1), xlsclients(1)