Wmii is a small, dynamic window manager for X11.

wmii is a small, dynamic window manager for X11. It is scriptable, has a 9p filesystem interface and supports classic and tiling (acme-like) window management. It aims to maintain a small and clean (read hackable and beautiful) codebase.

Links.

Latest release: wmii 3.9.2 (recommended)
Latest devel tip: hg clone http://hg.suckless.org/wmii
Bugs: Google Code issue tracker
Mailing List: dev+subscribe@suckless.org (Archives) (Old Archives) (see community for details)
IRC channel: #suckless at irc.oftc.net

Development.
You can browse its source code repository or get a copy using Mercurial with following command:

hg clone http://hg.suckless.org/libixp
hg clone http://hg.suckless.org/wmii

Older releases.

wmii-3.6 (historical, 2007-11-16)
wmii-3.5.1 (historical, 2006-12-27)
wmii-3.1 (historical, 2006-06-17)
wmii-2.5.2 (historical, 2006-01-27)
wmii-2 (historical, 2005-10-21)

Make sure that the X Window System headers are installed if you want to build wmii from source.

Packages.
If there are no packages for your Linux distribution/OS yet, ask the appropriate maintainers to create one or compile wmii from source.

Debian.
Official debian packages are available in the unstable and testing repository on debian.org. Backports for stable are available on backports.org. Prospective packages and/or snapshots can be downloaded from the maintainers website. There is also a user-supplied apt repository at dpkg.org.
wmii also comes with debian packaging materials. To build a deb, type:

make deb-dep # Installs any missing build dependencies.
make deb     # Builds a deb

See also Ubuntu, below.

Ubuntu.
Official ubuntu packages are available in the universe repository. Up-to-date snapshots are also available in the wmii Launchpad PPA. These packages may also work on debian systems. To build your own deb, see Debian above.

Arch Linux.

wmii-3.6 is available in the Arch [extra] repository.
wmii-hg is available in AUR [unsupported]. Building with makepkg pulls the latest hg revision.

It is also possible to build an Arch package by simply running makepkg from the base of the wmii source tree.
For up-do-date packages, you can add the suckless repo to /etc/pacman.conf:

[suckless]
Server = http://dl.suckless.org/arch/$arch

Gentoo.

Ebuild is available at x11-wm/wmii.

Source Mage.
A Source Mage spell for the 20070516 wmii snapshot is available. As usual, just type
cast wmii
in a term to install it.

FreeBSD.
Port is available at x11-wm/wmii.

NetBSD.
A pkgsrc package for wmii is available in wm/wmii and wip/wmii-devel.

OpenBSD.
wmii is included in the OpenBSD ports tree (x11/wmii), and binary packages are available from most OpenBSD mirrors.

Configuration and installation.

First of all, have a look if there are binary packages of wmii in your distribution. Debian, Ubuntu and Gentoo should already have good packages. If you found a trustworthy package, you may now safely skip this section.
For all those who are still reading this, let me tell you that you are on the good side because if you grab the sources and compile them yourself you'll benefit from having everything in it's original place, which will ease your use of wmii.

Uninstalling a previous version:
```
cd /path/to/wmii-previous
make uninstall && make clean
```
In case you're installing a newer version of wmii, this is the first thing you should do otherwise you'll end up mixing binaries, configuration files and manual-pages of different and potentially incompatible versions.
Unpack it:
```
tar xzf wmii-3.tar.gz
cd wmii-3
```
Edit the configuration:
```
vim config.mk
```
The most important variable to set is the PREFIX, which states, where you want wmii-3 to be installed to. If you are unsure, keep the default, it won't break your system.
Run make and make install:
```
make && make install
```
Setup the X-server to start wmii as your default window manager. You may do that by editing the file ~/.xinitrc.
```
#!/bin/sh
exec wmii
```

Now you are finished. Please note that autoconf tools are not used for various reasons ⁶. Please don't ask the wmii developers to use autoconf, they won't listen to you.

Screenshots.