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: 10 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/0intro/wmii
• Owner: 0intro
• License: mit
• Created: 2016-11-23T07:34:25.000Z (about 8 years ago)
• Default Branch: main
• Last Pushed: 2023-09-30T20:57:57.000Z (over 1 year ago)
• Last Synced: 2024-11-04T10:44:06.144Z (2 months ago)
• Language: C
• Homepage:
• Size: 22.1 MB
• Stars: 114
• Watchers: 10
• Forks: 13
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: NEWS
  • License: LICENSE

Awesome Lists containing this project

• awesome-acme - wmii - A small, scriptable window manager (Inspired By)
• awesome-ricing - wmii - A small, scriptable window manager, with a 9P filesystem interface and an acme-like layout. (C) (Packages / window-managers)

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