added TODO to updategeom in order to implement a decent version of it soon
[dwm.git] / README
1 dwm - dynamic window manager
2 ============================
3 dwm is an extremely fast, small, and dynamic window manager for X.
4
5
6 Requirements
7 ------------
8 In order to build dwm you need the Xlib header files.
9
10
11 Installation
12 ------------
13 Edit config.mk to match your local setup (dwm is installed into
14 the /usr/local namespace by default).
15
16 Afterwards enter the following command to build and install dwm (if
17 necessary as root):
18
19     make clean install
20
21 If you are going to use the default bluegray color scheme it is highly
22 recommended to also install the bluegray files shipped in the dextra package.
23
24
25 Running dwm
26 -----------
27 Add the following line to your .xinitrc to start dwm using startx:
28
29     exec dwm
30
31 In order to connect dwm to a specific display, make sure that
32 the DISPLAY environment variable is set correctly, e.g.:
33
34     DISPLAY=foo.bar:1 exec dwm
35
36 (This will start dwm on display :1 of the host foo.bar.)
37
38 In order to display status info in the bar, you can do something
39 like this in your .xinitrc:
40
41     while true
42     do
43         xsetroot -name "`date` `uptime | sed 's/.*,//'`"
44         sleep 1
45     done &
46     exec dwm
47
48
49 Configuration
50 -------------
51 The configuration of dwm is done by creating a custom config.h
52 and (re)compiling the source code.