uh-wm/README.md

uh-wm

uh-wm is a minimalistic tiling and stacking window manager for X. It shares some similarities with dwm and wmii, but is written in ruby so you can configure and extend features with ruby code.

The layout strategy is interchangeable, the default one being the uh-layout ruby gem. A layout is a simple object obeying a defined protocol.

Features:

• Xinerama support;

• Multiple event handling strategy: blocking or multiplexing (select());

• Configuration with a run control file;

• Key bindings with user defined code as callback;

• Configurable modifier key;

• Support user-defined layout strategy;

• Program execution via key binding.

• No re-parenting (so no window decoration either);

• No grabbing of the modifier key;

• No mouse handling;

• Very limited ICCCM support.

Getting started

Installation (requires ruby ~> 2.1 with rubygems)

$ gem install uh-wm

Usage

Usage: uhwm [options]

options:
    -v, --verbose                    enable verbose mode
    -d, --debug                      enable debug mode
    -f, --run-control PATH           specify alternate run control file
    -r, --require PATH               require ruby feature
    -l, --layout LAYOUT              specify layout
    -w, --worker WORKER              specify worker

    -h, --help                       print this message
    -V, --version                    print version