Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
evilwm(1)							     evilwm(1)

       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
       ] [ -altmask modifier ] [ [ -app	name/class ] [ -geometry geometry ]  [
       -dock ] [ -vdesk	vdesk ]	[ -fixed ] ]...	 [ -nosoliddrag	] [ -V ]

       evilwm  is  a minimalist	window manager based on	aewm, extended to fea-
       ture 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

       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

       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.

       -display	display
	      specifies	the X display to run on.

       -term termprog
	      specifies	an alternative program to run when spawning a new ter-
	      minal  (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  pix-
	      els 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	 modi-
	      fiers  are  shift,  lock,	 control, alt, mod1, mod2, mod3, mod4,

       -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 prop-
	      erty).  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	appli-
	      cations 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).

	      draw a window outline while moving or resizing.

       -V     print version number.

       evilwm  will also read options, one per line, from a file called	.evil-
       wmrc 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.


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

       Ciaran Anscomb <>.
       aewm was	written	by Decklin Foster <>.
       9wm was written by David	Hogan <>.

       xterm(1), xprop(1)

			       October 13, 2010			     evilwm(1)


Want to link to this manual page? Use this URL:

home | help