wmii/README

92 lines
2.8 KiB
Plaintext
Raw Normal View History

2005-11-18 18:54:58 +03:00
Abstract
--------
2007-03-23 19:30:50 +03:00
window manager improved-improved is a dynamic window manager for X11.
2006-02-11 17:42:54 +03:00
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.
2005-11-18 18:54:58 +03:00
Requirements
------------
2007-04-20 10:52:33 +04:00
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.
2005-11-18 18:54:58 +03:00
Installation
------------
2007-04-20 10:52:33 +04:00
First, edit config.mk to match your local setup, or to let us guess it, run:
make config
2005-11-18 18:54:58 +03:00
2007-04-20 10:52:33 +04:00
To build, simply run:
make
2005-11-18 18:54:58 +03:00
2007-04-20 10:52:33 +04:00
To install, run the following, as root, if necessary:
make install
2005-11-18 18:54:58 +03:00
Running wmii
------------
Add the following line to your .xinitrc to start wmii using startx:
2007-03-23 19:30:50 +03:00
until wmii; do
true
done
2005-11-18 18:54:58 +03:00
2007-04-20 10:52:33 +04:00
In order to connect wmii to a specific display, make sure that
the DISPLAY environment variable is set correctly. For example:
2005-11-18 18:54:58 +03:00
2007-04-20 10:52:33 +04:00
DISPLAY=:1 wmii
2005-11-18 18:54:58 +03:00
2007-04-20 10:52:33 +04:00
This will start wmii on display :1.
2005-11-18 18:54:58 +03:00
Configuration
-------------
2007-03-23 19:30:50 +03:00
The configuration of wmii is done by customizing the rc script rc.wmii.local,
which remotely controls the window manager and handles various events.
2007-03-23 19:30:50 +03:00
The main rc.wmii script lives in PREFIX/etc/wmii-3.5/, while rc.wmii.local
goes in $HOME/.wmii-3.5/.
2005-11-18 18:54:58 +03:00
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.
2005-11-18 18:54:58 +03:00
Credits
-------
2006-02-11 17:42:54 +03:00
The following people have contributed especially to wmii in various ways:
2005-11-18 18:54:58 +03:00
2006-02-11 17:46:24 +03:00
- Christoph Wegscheider <christoph dot wegscheider at wegi dot net>
2007-02-11 05:02:34 +03:00
- Georg Neis <gn at suckless dot org>
2006-02-11 17:46:24 +03:00
- Uwe Zeisberger <zeisberg at informatik dot uni-freiburg dot de>
- Uriel <uriel99 at gmail dot com>
2006-02-11 17:46:24 +03:00
- 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>
2006-02-11 17:46:24 +03:00
- 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>
2006-03-13 12:34:47 +03:00
- Salvador Peiro <saoret dot one at gmail dot com>
2006-03-13 12:31:04 +03:00
- Anthony Martin <ality at pbrane dot org>
- Icarus Sparry <wmii at icarus dot freeuk dot com>
2007-02-07 09:23:59 +03:00
- Norman Golisz <norman dot golisz at arcor dot de>
2006-03-13 12:34:47 +03:00
- Stefano K. Lee <wizinblack at gmail dot com >
2006-04-01 16:02:02 +04:00
- Stefan Tibus <sjti at gmx dot net>
- Neptun <neptun at gmail dot com>
2007-02-07 09:23:59 +03:00
- Daniel Wäber <_wabu at web dot de>
2005-11-18 18:54:58 +03:00
References
----------
[1] http://9p.cat-v.org
[2] http://plan9.us