sunaku's Ruby wmiirc:

  This is a Ruby[1] and YAML[2] based configuration of the wmii[3]
  window manager.  It manipulates wmii through the Rumai[4] library,
  which comes with an interactive shell[5] for live experimentation.

  [1] http://ruby-lang.org
  [2] http://yaml.org
  [3] http://wmii.suckless.org
  [4] http://snk.tuxfamily.org/lib/rumai/
  [5] http://snk.tuxfamily.org/lib/rumai/#Tutorial

  This configuration is also discussed in the following articles:

  * http://wmii.suckless.org/alternative_wmiirc_scripts
  * http://article.gmane.org/gmane.comp.window-managers.wmii/1704
  * http://snk.tuxfamily.org/web/2006-07-01-wmii-3-1-configuration-in-ruby.html

Prerequisites:

  * wmii 3.6 or newer     -  http://wmii.suckless.org
  * dmenu 4.0 or newer    -  http://tools.suckless.org/dmenu/
  * Ruby 1.9 or newer     -  http://www.ruby-lang.org
  * Rumai 3.2.0 or newer  -  gem install rumai

Installing:

  # backup
  mv ~/.wmii ~/.wmii.backup
  mv ~/.wmii-hg ~/.wmii-hg.backup

  # install
  git clone git://github.com/sunaku/wmiirc.git ~/.wmii
  ln -s ~/.wmii ~/.wmii-hg

  # branch
  cd ~/.wmii
  git checkout -b personal
  cp -vb example.yaml config.yaml

Configuring:

  * Edit ~/.wmii/config.yaml to your liking.

    For a real-life example, see my personal config.yaml file:
    http://github.com/sunaku/wmiirc/blob/personal/config.yaml

  * If wmii is already running, run ~/.wmii/wmiirc or
    invoke the "reload" action to apply your changes.

Running:

  * Ensure that your ~/.xinitrc supports crash recovery:

      xterm -e tail -f ~/.wmii/wmiirc.log &

      while true; do
        wmii
        xmessage 'Restart the Window Manager?' \
                 -buttons 'Yes:1,No:0' -center \
                 -default 'Yes' -timeout 30    \
        && break
      done

    This will allow you to restart wmii without losing your
    applications if it crashes or if you accidentally kill it.

  * If wmii is already running, run ~/.wmii/wmiirc to start the
    configuration.  Otherwise, run `startx` normally and wmii
    will automatically recognize and apply this configuration.

Upgrading:

  # assuming that "origin" points to github.com/sunaku/wmiirc
  git fetch origin
  git checkout master
  git rebase origin/master
  git checkout personal
  git rebase master

Contributing:

  Fork this project on GitHub and send pull requests.

Bugs, Features, Issues, Questions:

  File a report on the issue tracker:
  http://github.com/sunaku/wmiirc/issues/