MirOS Manual: evilwm(1)


evilwm(1)           UNIX Programmer's Manual            evilwm(1)

NAME

     evilwm - Minimalist Window Manager for X

SYNOPSIS

     evilwm [ -display display ] [ -term termprog ] [ -fg fore-
     ground ] [ -bg background ] [ -bw borderwidth ] [ -snap num
     ] [ -mask1 modifiers ] [ -mask2 modifiers ] [ -app
     name/class [ -g geometry ] [ -v vdesk ] ]... [ -V ]

DESCRIPTION

     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.

     `    Spawn a new X11R6 terminal in a sane state, not inher-
          iting the parent environment, resetting most values to
          defaults.

     Break
          Delete current window.

     Insert
          Lower current window.

     H, J, K, L
          Move window left, down, up or right (16 pixels).

MirOS BSD #10-current     July 11, 2010                         1

evilwm(1)           UNIX Programmer's Manual            evilwm(1)

     Y, U, B, N
          Move window to top-left, top-right, bottom-left or
          bottom-right of screen.

     Q, W, E, R
          These have the same meaning as HJKL, but resize the
          window. The Q and R keys decrease and increase, respec-
          tively, the width of the window, while W and E increase
          or decrease the height.

     The amount the window is resized by can be given by the
     application and defaults to one (1) pixel. In addition, no
     window is ever resized to less than one (1) pixel width or
     height by these keys.

     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.

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

     -fg foreground
          frame colour of currently active window.

MirOS BSD #10-current     July 11, 2010                         2

evilwm(1)           UNIX Programmer's Manual            evilwm(1)

     -bg background
          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 mousebutton controls and cycling win-
          dows (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 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. Use 0 for vdesk to set window
          as sticky.

     -V   print version number.

BUGS

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

AUTHOR

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

     evilwm was integrated into MirOS #4 by Thorsten "mirabilos"
     Glaser <tg@mirbsd.org>, who also wrote several extensions
     and re-added the "old move behaviour" for MirOS #8. Starting

MirOS BSD #10-current     July 11, 2010                         3

evilwm(1)           UNIX Programmer's Manual            evilwm(1)

     with MirOS #10, keyboard resizing behaves the same as key-
     board moving, regarding the mouse cursor.

     Some of the MirOS additions have been inspired by work done
     by Jonathan Schleifer <js@webkeks.org>.

SEE ALSO

     xterm(1), xlsclients(1)

MirOS BSD #10-current     July 11, 2010                         4

Generated on 2014-07-04 21:17:45 by $MirOS: src/scripts/roff2htm,v 1.79 2014/02/10 00:36:11 tg Exp $

These manual pages and other documentation are copyrighted by their respective writers; their source is available at our CVSweb, AnonCVS, and other mirrors. The rest is Copyright © 2002‒2014 The MirOS Project, Germany.
This product includes material provided by Thorsten Glaser.

This manual page’s HTML representation is supposed to be valid XHTML/1.1; if not, please send a bug report – diffs preferred.