JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
changed the status info README hint (more simple now, no extra script necessary)
[dwm.git] / README
1 dwm - dynamic window manager
2 ----------------------------
3 dwm is an extremly fast, small, and dynamic X11 window manager.
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
22 Running dwm
23 -----------
24 Add the following line to your .xinitrc to start dwm using startx:
25
26     exec dwm
27
28 In order to connect dwm to a specific display, make sure that
29 the DISPLAY environment variable is set correctly, e.g.:
30
31     DISPLAY=foo.bar:1 exec dwm
32
33 This will start dwm on display :1 of the host foo.bar.
34
35
36 Displaying status info
37 ----------------------
38 In order to display status info in the bar, you can do following
39 in .xinitrc:
40
41     while true
42     do
43         echo `date` `uptime | sed 's/.*://; s/,//g'`
44         sleep 5
45     done | dwm
46
47 Configuration
48 -------------
49 The configuration of dwm is done by customizing source code,
50 grep for CUSTOMIZE keyword.