evilwm(1) General Commands Manual evilwm(1)
NAME
evilwm--minimalist window manager for X11
SYNOPSIS
evilwm [OPTION]...
DESCRIPTION
evilwm is a minimalist window manager for the X Window System. It
features plenty of mouse and keyboard controls while providing a clean
display, uncluttered by less useful window furniture (like title bars).
OPTIONS
-display display
specifies the X display to run on. Usually this can be inferred
from the DISPLAY environment variable.
-term termprog
specifies an alternative program to run when spawning a new
terminal (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 colour, -fc colour, -bg colour
frame colour of currently active, fixed active, and inactive
windows respectively. Either specify an X11 colour name like
goldenrod, or a hex triplet like #DAA520.
-bw borderwidth
width of window borders in pixels.
-snap distance
enable snap-to-border support. distance is the proximity in
pixels to snap to.
-wholescreen
ignore monitor geometry and use the whole screen dimensions.
This is the old behaviour from before multi-monitor support was
implemented, and may still be useful, e.g., when one large
monitor is driven from multiple outputs.
-numvdesks value
number of virtual desktops to provide. Defaults to 8. Any extras
will only be accessible by pagers or using
Control+Alt+(Left/Right).
-nosoliddrag
draw a window outline while moving or resizing.
-mask1 modifiers, -mask2 modifiers, -altmask 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). 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. Note that virtual desktops are numbered from zero.
-f, -fixed
specify that application is to start with a fixed client window.
-help show help
-V show program version
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.
USAGE
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 (unless it is fixed, in which case blue), with other windows left
as a dark grey.
You can use the mouse to manipulate windows either by click/dragging
the single-pixel border (easier when they align with a screen edge), or
by holding down Alt and doing so anywhere in the 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
client.
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 the top-left, top-right, bottom-left or bottom-
right of the current monitor.
I Show information about current window.
Equals Maximise current window vertically on current monitor (toggle).
Holding Shift toggles horizontal maximization.
X Maximise current window to current monitor (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. Fixed windows remain visible when
you switch virtual desktop.
1--8 Switch to specific virtual desktop (internally, desktops are
numbered from zero, so this actually switches to desktops 0--7;
this only becomes important if you use application matching).
Left Switch to next lower numbered virtual desktop.
Right Switch to next higher numbered virtual desktop.
A Switch to the previously selected virtual desktop.
In addition to the above, Alt+Tab can be used to cycle through windows.
To make evilwm exit, kill the process.
FILES
$HOME/.evilwmrc
BUGS
The author's idea of friendly may differ to that of many other people.
LICENCE
Copyright (C) 1999-2021 Ciaran Anscomb <evilwm@6809.org.uk>
This is free software. You can do what you want to it, but if it breaks
something, you get to pay for the counselling. The code was originally
based on aewm, so this is distributed under the same terms, which
follow.
AEWM LICENCE
Copyright (c) 1998-2000 Decklin Foster.
THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS", WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES OF ANY KIND. IN NO EVENT SHALL THE AUTHOR BE HELD
LIABLE FOR ANY DAMAGES CONNECTED WITH THE USE OF THIS PROGRAM.
You are granted permission to copy, publish, distribute, and/or sell
copies of this program and any modified versions or derived works,
provided that this copyright and notice are not removed or altered.
Portions of the code were based on 9wm, which contains this license:
9wm is free software, and is Copyright (c) 1994 by David Hogan.
Permission is granted to all sentient beings to use this
software, to make copies of it, and to distribute those copies,
provided that:
(1) the copyright and licence notices are left intact
(2) the recipients are aware that it is free software
(3) any unapproved changes in functionality are either
(i) only distributed as patches
or (ii) distributed as a new program which is not called 9wm
and whose documentation gives credit where it is due
(4) the author is not held responsible for any defects
or shortcomings in the software, or damages caused by it.
There is no warranty for this software. Have a nice day.
SEE ALSO
xterm (1), xprop (1)
evilwm-1.3 July 2021 evilwm(1)