Go to file
Kris Maglione abc4b2e285 Add ScreenChange event. 2012-04-08 14:07:38 -04:00
alternative_wmiircs Add doc/mkfile for building wmii.pdf with an optional MAINFONT variable for building on systems without LinoType's Palatino font. 2011-09-27 02:13:58 -04:00
cmd Add ScreenChange event. 2012-04-08 14:07:38 -04:00
debian [debian] Fix some lintian warnings. 2010-07-07 22:47:39 +00:00
doc Add doc/mkfile for building wmii.pdf with an optional MAINFONT variable for building on systems without LinoType's Palatino font. 2011-09-27 02:13:58 -04:00
examples [menu] Update manual. Add file completion example. 2010-10-07 16:31:42 -04:00
img [menu] Add vertical mode. 2010-10-07 16:31:41 -04:00
include [wimenu] Add paste key binding. 2010-10-07 16:31:42 -04:00
lib Allow Mod+Mouse3 to resize windows and columns unidirectionally. 2011-09-15 14:07:51 -04:00
man Move pkg-config libs after other LDFLAGS. Closes issue #245. 2011-10-20 04:55:58 -04:00
mk Fix wmiirc problems in recent commits. 2010-10-13 17:33:02 -04:00
rc Remove broken support for local_events. Closes issue #229. 2011-09-19 16:34:03 -04:00
test Rearrange some things. 2010-06-14 10:30:23 -04:00
util Move pkg-config libs after other LDFLAGS. Closes issue #245. 2011-10-20 04:55:58 -04:00
.hgignore [python] Use distutils to compile and install pygmi/pyxp. 2010-06-27 17:47:45 -04:00
.hgsigs Added signature for changeset 3ea520ff8668c297a5c6b667a68b3c3a1f44fec5 2007-05-30 21:22:10 -04:00
DISTRIBUTORS Fix some DISTRIBUTORS typos spotted by Snader_LB (OFTC). 2011-05-27 19:52:23 -04:00
FAQ Use IXP_ASSERT_VERSION macro. 2010-06-17 18:23:25 -04:00
LICENSE Add locale charset crud. 2010-06-06 05:07:24 -04:00
Makefile [menu] Update manual. Add file completion example. 2010-10-07 16:31:42 -04:00
NEWS [python] Use distutils to compile and install pygmi/pyxp. 2010-06-27 17:47:45 -04:00
PKGBUILD [arch] Fix pkgdesc for pyxp/pygmi. 2010-07-07 00:37:58 -04:00
README Fix last commit. 2010-06-11 23:48:29 -04:00
TODO Best just read the diff. 2008-08-25 12:47:56 -04:00
config.mk [python] Use distutils to compile and install pygmi/pyxp. 2010-06-27 17:47:45 -04:00

README

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 <christoph dot wegscheider at wegi dot net>
- Georg Neis <gn at suckless dot org>
- Uwe Zeisberger <zeisberg at informatik dot uni-freiburg dot de>
- Uriel <uriel99 at gmail dot com>
- Scot Doyle <scot at scotdoyle dot com>
- Sebastian Hartmann <seb dot wmi at gmx dot de>
- Bernhard Leiner <bleiner at gmail dot com>
- Jonas Domeij <jonas dot domeij at gmail dot com>
- Vincent <10 dot 50 at free dot fr>
- Oliver Kopp <olly at flupp dot de>
- Sebastian Roth <sebastian dot roth at gmail dot com>
- Nico Golde <nico at ngolde dot de>
- Steve Hoffman <steveh at g2switchworks dot com>
- Christof Musik <christof at senfdax dot de>
- Steffen Liebergeld <perl at gmx dot org>
- Tobias Walkowiak <wal at ivu dot de>
- Sander van Dijk <a dot h dot vandijk at gmail dot com>
- Salvador Peiro <saoret dot one at gmail dot com>
- Anthony Martin <ality at pbrane dot org>
- Icarus Sparry <wmii at icarus dot freeuk dot com>
- Norman Golisz <norman dot golisz at arcor dot de>
- Stefano K. Lee <wizinblack at gmail dot com >
- Stefan Tibus <sjti at gmx dot net>
- Neptun <neptun at gmail dot com>
- Daniel Wäber <_wabu at web dot de>


References
----------
[1] http://9p.cat-v.org
[2] http://plan9.us