Go to file
Kris Maglione 79ad0dd568 Update selection and execution of wmiirc. 2009-09-28 17:24:01 -04:00
alternative_wmiircs Update selection and execution of wmiirc. 2009-09-28 17:24:01 -04:00
cmd Update selection and execution of wmiirc. 2009-09-28 17:24:01 -04:00
debian Run latex2man. Other cleanup. 2007-07-03 10:16:14 -04:00
doc Add alternative_wmiircs READMEs 2009-09-02 20:36:25 -04:00
img Add first, incomplete draft of new wmii guide/reference. Proofers? 2009-05-23 22:08:12 -04:00
include Add alternative_wmiircs READMEs 2009-09-02 20:36:25 -04:00
libbio Bunch of fixes. 2007-07-16 16:52:35 -04:00
libfmt Fix some warnings on 64 bit systems with fr*king gcc-4. 2008-01-31 16:32:24 -05:00
libregexp Makefile fix repported by jakob@pipefour.org 2007-10-04 06:30:43 +02:00
libutf Pre-merge mess. 2008-01-18 15:05:45 -05:00
libwmii_hack Best just read the diff. 2008-08-25 12:47:56 -04:00
man Cleanup pre-install text file filters. 2009-09-28 17:24:01 -04:00
mk Cleanup pre-install text file filters. 2009-09-28 17:24:01 -04:00
rc Cleanup pre-install text file filters. 2009-09-28 17:24:01 -04:00
test Add a gravity test program. 2008-02-04 18:19:33 -05:00
util Makefile cleanup and other general cleanup. 2009-09-17 09:27:11 -04:00
.hgignore Fix some residual uses of .O extension 2009-09-03 15:33:06 -04:00
.hgsigs Added signature for changeset 3ea520ff8668c297a5c6b667a68b3c3a1f44fec5 2007-05-30 21:22:10 -04:00
DISTRIBUTORS Several changes: 2008-01-20 18:00:21 -05:00
LICENSE Update copyright dates, allow space indents in wmiirc key/event specs, fix 'Urgent toggle'. 2009-05-13 12:57:22 -04:00
Makefile Update selection and execution of wmiirc. 2009-09-28 17:24:01 -04:00
NEWS Update NEWS 2008-10-27 22:37:36 -04:00
NOTES Several changes: 2008-01-20 18:00:21 -05:00
README Several changes: 2008-01-20 18:00:21 -05:00
TODO Best just read the diff. 2008-08-25 12:47:56 -04:00
config.mk Use pkg-config globally. 2009-05-21 14:22:58 -04:00

README

Abstract
--------
window manager improved-improved 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
and dmenu are used by the default scripts. libixp and dmenu can be obtained
from http://suckless.org/. Either plan9port[2] or 9base is recommended.
If you have the wmii+ixp distribution, libixp is already provided.


Installation
------------
First, edit config.mk to match your local setup, or to let us guess it, run:
	make config

To build, simply run:
	make

To install, run the following, as root, if necessary:
	make install

Running wmii
------------
Add the following line to your .xinitrc to start wmii using startx:

    until wmii; do
	true
    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 rc.wmii.local,
which remotely controls the window manager and handles various events.
The main rc.wmii script lives in PREFIX/etc/wmii-3.5/, while rc.wmii.local
goes in $HOME/.wmii-3.5/.

If you wish to unbind keys bound by rc.wmii in rc.wmii.local, you
must do so inside the function Action-overridekeys. You may,
however, define new keys or redefine keys anywhere.

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