Go to file
Kris Maglione c4e7c2de67 Allow _NET_ACTIVE_WINDOW requests from clients, if they have recent user activity. Rationale:
I don't like allowing clients to activate windows, because they
usually seem to do it for annoying reasons. However, system tray
icons usually activate their main windows when clicked, which is
what the user expects. So, as a comprimise, only allow the action if
the user has recently interacted with them.
2010-05-27 18:05:27 -04:00
alternative_wmiircs [pygmi] Don't launch background processes with IO pipes. Restore SIGPIPE. (Closes issue #176) 2010-05-24 13:04:40 -04:00
cmd Allow _NET_ACTIVE_WINDOW requests from clients, if they have recent user activity. Rationale: 2010-05-27 18:05:27 -04:00
debian Install wmii.desktop on debian. 2010-05-26 09:20:14 -04:00
doc Allow colrules to be specified in pixels. 2010-05-22 11:15:57 -04:00
img Remove last hardcoded reference to ~/.wmii-3.5 from man pages. 2010-05-25 14:39:48 -04:00
include Add witray system tray program. 2010-05-27 03:58:02 -04:00
lib Don't call getpid() for every window creation. 2010-05-27 17:37:50 -04:00
man Add witray system tray program. 2010-05-27 03:58:02 -04:00
mk Don't focus dock or splash windows except via EWMH ACTIVE_WINDOW requests. 2010-05-27 14:14:37 -04:00
rc [dev] [wmii] fix for possible minor typos 2009-10-25 23:29:48 -04:00
test Factor out common code into library. 2010-05-21 22:52:47 -04:00
util Add witray system tray program. 2010-05-27 03:58:02 -04:00
.hgignore Add forgotten header. 2010-05-22 16:09:21 -04:00
.hgsigs Added signature for changeset 3ea520ff8668c297a5c6b667a68b3c3a1f44fec5 2007-05-30 21:22:10 -04:00
config.mk [witray] Handle badly behavied clients. Closes issue #183. 2010-05-27 13:55:34 -04:00
DISTRIBUTORS Update DISTRIBUTERS for clarity. Install LICENSE file by default. 2009-10-13 21:37:04 -04:00
LICENSE fixed email address 2009-11-28 11:58:57 +00:00
Makefile Fix 'make deb' when not in a hg repo. 2010-05-24 10:14:02 -04:00
NEWS Cleanup the top directory a bit. sed -i 's/\$\{([^{]+)\}/$(\1)/g' **/Makefile **/*.mk 2010-05-22 20:55:16 -04:00
PKGBUILD Add witray system tray program. 2010-05-27 03:58:02 -04:00
README More doc updates. Add wmiir.1. 2009-10-12 22:07:51 -04:00
TODO Best just read the diff. 2008-08-25 12:47:56 -04:00

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 @CONFPREFIX@/wmii@CONFVERSION@/, while
wmiirc_local goes in $HOME/.wmii@CONFVERSION@/.

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