wmii

git clone git://oldgit.suckless.org/wmii/
Log | Files | Refs | README | LICENSE

README (2918B)

      1 Abstract
      2 --------
      3 wmii is a dynamic window manager for X11.  It supports classic and
      4 tiled window management with extended keyboard, mouse, and 9P-based[1]
      5 remote control.  It consists of the wmii(1) window manager and the
      6 wmiir(1) the remote access utility.
      7 
      8 
      9 Requirements
     10 ------------
     11 In order to build wmii you need the Xlib header files and libixp.
     12 xmessage is used by the default scripts.  Libixp, if not provided, can
     13 be obtained from http://libs.suckless.org/.  On debian, you should be
     14 able to obtain all dependencies by running `make deb-dep`.  Python is
     15 recommended for more advanced configurations.
     16 
     17 
     18 Installation
     19 ------------
     20 First, edit config.mk to match your local setup.
     21 
     22 To build, simply run:
     23 	make
     24 
     25 To install, run the following, as root if necessary:
     26 	make install
     27 
     28 On debian, you should only have to run `make deb` to create a debian
     29 package.  No further configuration should be necessary.
     30 
     31 
     32 Running wmii
     33 ------------
     34 Add the following line to your .xinitrc to start wmii using startx:
     35 
     36     until wmii; do :; done
     37 
     38 In order to connect wmii to a specific display, make sure that the
     39 DISPLAY environment variable is set correctly.  For example:
     40 
     41     DISPLAY=:1 wmii
     42 
     43 This will start wmii on display :1.
     44 
     45 
     46 Configuration
     47 -------------
     48 The configuration of wmii is done by customizing the rc script wmiirc,
     49 which remotely controls the window manager and handles various events.
     50 The main wmiirc script lives in @GLOBALCONF@ while wmiirc_local goes
     51 in @LOCALCONF@.
     52 
     53 More advanced versions of wmiirc are provided in python and ruby.
     54 For more information on them, see alternative_wmiircs/README.
     55 
     56 Credits
     57 -------
     58 The following people have contributed especially to wmii in various
     59 ways:
     60 
     61 - Christoph Wegscheider <christoph dot wegscheider at wegi dot net>
     62 - Georg Neis <gn at suckless dot org>
     63 - Uwe Zeisberger <zeisberg at informatik dot uni-freiburg dot de>
     64 - Uriel <uriel99 at gmail dot com>
     65 - Scot Doyle <scot at scotdoyle dot com>
     66 - Sebastian Hartmann <seb dot wmi at gmx dot de>
     67 - Bernhard Leiner <bleiner at gmail dot com>
     68 - Jonas Domeij <jonas dot domeij at gmail dot com>
     69 - Vincent <10 dot 50 at free dot fr>
     70 - Oliver Kopp <olly at flupp dot de>
     71 - Sebastian Roth <sebastian dot roth at gmail dot com>
     72 - Nico Golde <nico at ngolde dot de>
     73 - Steve Hoffman <steveh at g2switchworks dot com>
     74 - Christof Musik <christof at senfdax dot de>
     75 - Steffen Liebergeld <perl at gmx dot org>
     76 - Tobias Walkowiak <wal at ivu dot de>
     77 - Sander van Dijk <a dot h dot vandijk at gmail dot com>
     78 - Salvador Peiro <saoret dot one at gmail dot com>
     79 - Anthony Martin <ality at pbrane dot org>
     80 - Icarus Sparry <wmii at icarus dot freeuk dot com>
     81 - Norman Golisz <norman dot golisz at arcor dot de>
     82 - Stefano K. Lee <wizinblack at gmail dot com >
     83 - Stefan Tibus <sjti at gmx dot net>
     84 - Neptun <neptun at gmail dot com>
     85 - Daniel Wäber <_wabu at web dot de>
     86 
     87 
     88 References
     89 ----------
     90 [1] http://9p.cat-v.org
     91 [2] http://plan9.us
     92