Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/0intro/wmii

A small, scriptable window manager, with a 9P filesystem interface and an acme-like layout.
https://github.com/0intro/wmii

Last synced: about 2 months ago
JSON representation

A small, scriptable window manager, with a 9P filesystem interface and an acme-like layout.

Lists

README

        

[![Build Status](https://github.com/0intro/wmii/workflows/C/badge.svg)](https://github.com/0intro/wmii/actions/workflows/c.yml)
[![Coverity Scan Build Status](https://scan.coverity.com/projects/0intro-wmii/badge.svg)](https://scan.coverity.com/projects/0intro-wmii)

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