Go to file
Kris Maglione 4ecc7f5ea6 Added PLAN9BASE config.mk knob that evaluates to $PLAN9 or /usr/local/plan9 if unset. 2007-03-02 17:11:09 -05:00
rc Added PLAN9BASE config.mk knob that evaluates to $PLAN9 or /usr/local/plan9 if unset. 2007-03-02 17:11:09 -05:00
9menu.c Cleanup 9menu some. Remember the last menu item selected. 2007-02-28 21:18:26 -05:00
LICENSE fixed links and some facts in the readme 2006-12-24 00:39:37 +01:00
LICENSE.p9p Added intmap.c and LICENSE from p9p at least for the short term 2006-06-13 18:42:20 -04:00
Makefile Added PLAN9BASE config.mk knob that evaluates to $PLAN9 or /usr/local/plan9 if unset. 2007-03-02 17:11:09 -05:00
README Refactoring in column.c 2007-02-10 21:02:34 -05:00
TODO Add new TODO file 2007-02-19 20:55:59 +01:00
area.c Fix selection of views by index. 2007-02-27 01:57:01 -05:00
bar.c Have wmiimenu take colors from WMII_(NORM FOCUS)COLORS. Get rid of 'extern' from function decls. 2007-02-23 23:09:58 -05:00
client.c Implemented the Aspect hint, as well as some moderate cleanup. 2007-03-02 03:13:32 -05:00
column.c Implemented the Aspect hint, as well as some moderate cleanup. 2007-03-02 03:13:32 -05:00
config.mk Added PLAN9BASE config.mk knob that evaluates to $PLAN9 or /usr/local/plan9 if unset. 2007-03-02 17:11:09 -05:00
draw.c New column scaling code. Fixed accidental resize on click of unfocused client. New public domain util.c. Some other stuff. 2007-02-14 23:20:47 -05:00
event.c Implemented the Aspect hint, as well as some moderate cleanup. 2007-03-02 03:13:32 -05:00
frame.c Implemented the Aspect hint, as well as some moderate cleanup. 2007-03-02 03:13:32 -05:00
fs.c Fix Suraj's segfault, hopefully. 2007-02-28 17:19:15 -05:00
geom.c Focus windows when entering their titlebars, except when stacked. 2007-02-23 16:03:20 -05:00
key.c Have wmiimenu take colors from WMII_(NORM FOCUS)COLORS. Get rid of 'extern' from function decls. 2007-02-23 23:09:58 -05:00
main.c Have wmiimenu take colors from WMII_(NORM FOCUS)COLORS. Get rid of 'extern' from function decls. 2007-02-23 23:09:58 -05:00
mouse.c Implemented the Aspect hint, as well as some moderate cleanup. 2007-03-02 03:13:32 -05:00
printevent.c Have wmiimenu take colors from WMII_(NORM FOCUS)COLORS. Get rid of 'extern' from function decls. 2007-02-23 23:09:58 -05:00
printevent.h Really add printevent.[ch] 2007-02-09 12:50:04 -05:00
rule.c Have wmiimenu take colors from WMII_(NORM FOCUS)COLORS. Get rid of 'extern' from function decls. 2007-02-23 23:09:58 -05:00
util.c New column scaling code. Fixed accidental resize on click of unfocused client. New public domain util.c. Some other stuff. 2007-02-14 23:20:47 -05:00
view.c Removed semicolon after for loop in rects_of_view 2007-02-16 17:24:39 -05:00
wmii Test -e $PLAN9/bin/rc in wmii script. Use AWKPATH config.mk flag instead of /usr/bin/awk. 2007-02-26 06:53:02 -05:00
wmii.1 Replaced all occurrences of CONFVERSION with 3.5 in the man pages. 2007-02-20 19:24:45 +01:00
wmii.eps Removed www tagrule from rc.wmii. It was not meant to be there. 2007-02-28 01:00:05 -05:00
wmii.h Implemented the Aspect hint, as well as some moderate cleanup. 2007-03-02 03:13:32 -05:00
wmii.mp Replaced wmii.svg with wmii.eps and wmii.mp (wmii and XML/Inkscape don't mesh). 2007-02-27 19:12:57 -05:00
wmiiloop Test -e $PLAN9/bin/rc in wmii script. Use AWKPATH config.mk flag instead of /usr/bin/awk. 2007-02-26 06:53:02 -05:00
wmiiloop.1 Replace Action- with Action_ in wmiirc 2007-02-25 14:25:42 -05:00
wmiir Renamed selcolors back to focuscolors. Fixed an early free(). 2007-02-15 16:46:31 -05:00
wmiir.1 fixed wmiir manpage: using ls to list direcories instead of read 2006-12-27 11:53:10 +01:00
wmiiwm.1 updated manpages; a 's/CONFPREFIX/${CONFPREFIX}/' has been forgotten which left artifacts in installed manpages, fixed 2006-12-23 23:27:54 +01:00

README

Abstract
--------
window manager improved 2 is a dynamic window manager for X11.
It supports classic and tiled window management with extended
keyboard, mouse, and 9P-based [2] remote control.
It consists of the wmiiwm(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. Further
dependencies are xmessage and dmenu. libixp and dmenu can be obtained from
[1].


Installation
------------
Edit config.mk to match your local setup. wmii is installed into
the /usr/local hierarchy by default.

Afterwards enter the following command to build and install wmii (if
necessary as root):

    make clean install


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

    exec wmii

In order to connect wmii or wmiir to a specific display, make sure that
the DISPLAY environment variable is set correctly, e.g.:

    DISPLAY=foo.bar:1 exec wmii

This will start wmii on display :1 of the host foo.bar.


Configuration
-------------
The configuration of wmii is done by customizing the sh script wmiirc,
which remotely controls the window manager and handles various events.
Copy the file from PREFIX/etc/wmii-3.5/ (usually /usr/local/etc/wmii-3.5/)
to $HOME/.wmii-3.5/ and edit it to fit your needs.


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 <uriel at suckless dot org>
- 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://suckless.org
[2] http://www.cs.bell-labs.com/sys/man/5/INDEX.html