Go to file
David du Colombier 489c9e47f4 add libxinerama-dev and libxrandr-dev dependencies in Travis CI 2018-05-20 20:01:15 +02:00
alternative_wmiircs Run wipescreens on Screenchange event in python/wmiirc. 2014-06-03 21:41:40 -07:00
cmd Fix the patch in LD_PRELOAD for wihack 2013-12-09 17:43:36 +01: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 Rebuild wimenu.1 2014-08-02 15:22:00 -07:00
mk fix build on Ubuntu 12.04 2017-07-28 13:53:31 +02:00
rc Fix Notice command. 2013-12-09 17:43:36 +01: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
.travis.yml add libxinerama-dev and libxrandr-dev dependencies in Travis CI 2018-05-20 20:01:15 +02: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 rename README to README.md in Makefile 2018-05-19 23:04:43 +02: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.md add build badges 2017-03-31 13:19:12 +02: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.md

Build Status Coverity Scan Build Status

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
  • Georg Neis
  • Uwe Zeisberger
  • Uriel
  • Scot Doyle
  • Sebastian Hartmann
  • Bernhard Leiner
  • Jonas Domeij
  • Vincent <10 dot 50 at free dot fr>
  • Oliver Kopp
  • Sebastian Roth
  • Nico Golde
  • Steve Hoffman
  • Christof Musik
  • Steffen Liebergeld
  • Tobias Walkowiak
  • Sander van Dijk
  • Salvador Peiro
  • Anthony Martin
  • Icarus Sparry
  • Norman Golisz
  • Stefano K. Lee
  • Stefan Tibus
  • Neptun
  • Daniel Wäber <_wabu at web dot de>

References

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