README
author Anselm R. Garbe <garbeam@wmii.de>
Tue, 11 Jul 2006 21:24:10 +0200
changeset 18 1efa34c6e1b6
parent 17 aaf520f53110
child 32 082c75b937b5
permissions -rw-r--r--
added mouse-based resizals
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     1
gridwm
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     2
------
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     3
17
aaf520f53110 updated README
Anselm R. Garbe <garbeam@wmii.de>
parents: 9
diff changeset
     4
gridwm is an extremly fast, small, and automatic X11 window manager.  It
aaf520f53110 updated README
Anselm R. Garbe <garbeam@wmii.de>
parents: 9
diff changeset
     5
arranges all windows in a grid.
aaf520f53110 updated README
Anselm R. Garbe <garbeam@wmii.de>
parents: 9
diff changeset
     6
aaf520f53110 updated README
Anselm R. Garbe <garbeam@wmii.de>
parents: 9
diff changeset
     7
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     8
Requirements
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     9
------------
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    10
In order to build gridwm you need the Xlib header files.
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    11
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    12
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    13
Installation
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    14
------------
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    15
Edit config.mk to match your local setup. gridwm is installed into
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    16
the /usr/local namespace by default.
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    17
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    18
Afterwards enter the following command to build and install gridwm (if
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    19
necessary as root):
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    20
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    21
    make clean install
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    22
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    23
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    24
Running gridwm
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    25
--------------
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    26
Add the following line to your .xinitrc to start gridwm using startx:
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    27
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    28
    exec gridwm
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    29
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    30
In order to connect gridwm to a specific display, make sure that
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    31
the DISPLAY environment variable is set correctly, e.g.:
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    32
17
aaf520f53110 updated README
Anselm R. Garbe <garbeam@wmii.de>
parents: 9
diff changeset
    33
    DISPLAY=foo.bar:1 exec gridwm
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    34
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    35
This will start gridwm on display :1 of the host foo.bar.
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    36
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    37
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    38
Configuration
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    39
-------------
17
aaf520f53110 updated README
Anselm R. Garbe <garbeam@wmii.de>
parents: 9
diff changeset
    40
The configuration of gridwm is done by customizing the config.h source file. To
18
1efa34c6e1b6 added mouse-based resizals
Anselm R. Garbe <garbeam@wmii.de>
parents: 17
diff changeset
    41
customize the key bindings edit kb.c. To change the status output, edit the
17
aaf520f53110 updated README
Anselm R. Garbe <garbeam@wmii.de>
parents: 9
diff changeset
    42
status command definition in wm.c.
aaf520f53110 updated README
Anselm R. Garbe <garbeam@wmii.de>
parents: 9
diff changeset
    43