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