JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
added a note how to achieve status info in the bar
[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     $HOME/.dwm/status | dwm
42
43 Assumed $HOME/.dwm/status is an executable script like:
44
45     #!/bin/sh
46     while true
47     do
48         echo `date` `uptime | sed 's/.*://; s/,//g'`
49         sleep 5
50     done
51
52
53 Configuration
54 -------------
55 The configuration of dwm is done by customizing source code,
56 grep for CUSTOMIZE keyword.