Added sample .xinitrc file
[dwm.git] / README
1 dwm - dynamic window manager
2 ============================
3 dwm is an extremely fast, small, and dynamic window manager for X.
4
5 This version was edited by Gabriel PĂ©rez-Cerezo (gpcf.eu) to include
6 keybindings that don't conflict with emacs and some useful shortcuts.
7
8 This file may change at any time, because if my needs change, this
9 window manager will change also. If you don't like my changes, please
10 fork this version of DWM.
11
12
13 Requirements
14 ------------
15 In order to build dwm you need the Xlib header files.
16
17
18 Installation
19 ------------
20
21 See the INSTALL file for instructions on how to install on dwm on Debian
22 GNU/Linux.
23
24 Edit config.mk to match your local setup (dwm is installed into
25 the /usr/local namespace by default).
26
27 Afterwards enter the following command to build and install dwm (if
28 necessary as root):
29
30 make clean install
31
32 If you are going to use the default bluegray color scheme it is highly
33 recommended to also install the bluegray files shipped in the dextra package.
34
35
36 Running dwm
37 -----------
38 Add the following line to your .xinitrc to start dwm using startx:
39
40 exec dwm
41
42 In order to connect dwm to a specific display, make sure that
43 the DISPLAY environment variable is set correctly, e.g.:
44
45 DISPLAY=foo.bar:1 exec dwm
46
47 (This will start dwm on display :1 of the host foo.bar.)
48
49 In order to display status info in the bar, you can do something
50 like this in your .xinitrc:
51
52 while xsetroot -name "`date` `uptime | sed 's/.*,//'`"
53 do
54 sleep 1
55 done &
56 exec dwm
57
58
59 Configuration
60 -------------
61 The configuration of dwm is done by creating a custom config.h
62 and (re)compiling the source code.