about summary refs log tree commit diff stats
path: root/README
blob: 4f46c8bd17fe4503c72290604bcf7b5aebadb321 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
gridwm
------

gridwm is an extremly fast, small, and automatic X11 window manager.  It
arranges all windows in a grid.


Configuration
-------------
You have to edit the source code for configuration, this WM is intended to
provide sane defaults, if something doesn't fits your needs, edit config.h and
maybe key.c. To change the status output edit that status variable definition
in wm.c.


Requirements
------------
In order to build gridwm you need the Xlib header files.


Installation
------------
Edit config.mk to match your local setup. gridwm is installed into
the /usr/local namespace by default.

Afterwards enter the following command to build and install gridwm (if
necessary as root):

    make clean install


Running gridwm
--------------
Add the following line to your .xinitrc to start gridwm using startx:

    exec gridwm

In order to connect gridwm to a specific display, make sure that
the DISPLAY environment variable is set correctly, e.g.:

    DISPLAY=foo.bar:1 exec gridwm

This will start gridwm on display :1 of the host foo.bar.


Configuration
-------------
The configuration of gridwm is done by customizing the config.h source file. To
customize the key bindings edit key.c. To change the status output, edit the
status command definition in wm.c.