489c9e47f4 | ||
---|---|---|
alternative_wmiircs | ||
cmd | ||
debian | ||
doc | ||
examples | ||
img | ||
include | ||
lib | ||
man | ||
mk | ||
rc | ||
test | ||
util | ||
.hgignore | ||
.hgsigs | ||
.travis.yml | ||
DISTRIBUTORS | ||
FAQ | ||
LICENSE | ||
Makefile | ||
NEWS | ||
PKGBUILD | ||
README.md | ||
TODO | ||
config.mk |
README.md
Abstract
wmii is a dynamic window manager for X11. It supports classic and tiled window management with extended keyboard, mouse, and 9P-based[1] remote control. It consists of the wmii(1) window manager and the wmiir(1) the remote access utility.
Requirements
In order to build wmii you need the Xlib header files and libixp.
xmessage is used by the default scripts. Libixp, if not provided, can
be obtained from http://libs.suckless.org/. On debian, you should be
able to obtain all dependencies by running make deb-dep
. Python is
recommended for more advanced configurations.
Installation
First, edit config.mk to match your local setup.
To build, simply run: make
To install, run the following, as root if necessary: make install
On debian, you should only have to run make deb
to create a debian
package. No further configuration should be necessary.
Running wmii
Add the following line to your .xinitrc to start wmii using startx:
until wmii; do :; done
In order to connect wmii to a specific display, make sure that the DISPLAY environment variable is set correctly. For example:
DISPLAY=:1 wmii
This will start wmii on display :1.
Configuration
The configuration of wmii is done by customizing the rc script wmiirc, which remotely controls the window manager and handles various events. The main wmiirc script lives in @GLOBALCONF@ while wmiirc_local goes in @LOCALCONF@.
More advanced versions of wmiirc are provided in python and ruby. For more information on them, see alternative_wmiircs/README.
Credits
The following people have contributed especially to wmii in various ways:
- Christoph Wegscheider
- Georg Neis
- Uwe Zeisberger
- Uriel
- Scot Doyle
- Sebastian Hartmann
- Bernhard Leiner
- Jonas Domeij
- Vincent <10 dot 50 at free dot fr>
- Oliver Kopp
- Sebastian Roth
- Nico Golde
- Steve Hoffman
- Christof Musik
- Steffen Liebergeld
- Tobias Walkowiak
- Sander van Dijk
- Salvador Peiro
- Anthony Martin
- Icarus Sparry
- Norman Golisz
- Stefano K. Lee
- Stefan Tibus
- Neptun
- Daniel Wäber <_wabu at web dot de>
References
[1] http://9p.cat-v.org [2] http://plan9.us