JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
say it's a fork, add overview of differences
[dwm.git] / README
1 JasonWoof's fork of dwm - dynamic window manager
2 ================================================
3 dwm is an extremely fast, small, and dynamic window manager for X.
4
5 JasonWoof's modifications include:
6
7 1.      A new layout that's kinda like deck, but there's a little space above and
8         below the main slave window where you can see (a little bit of) the other
9         slave windows.
10
11 2.      When you've got only 1 window in a workspace: by default, it is in the
12         master area. A new tag/attribute is used to specify windows that should use
13         all available space when alone. This results in fewer window resizes, and
14         is nice for applications which are usually not so nice when they're huge
15         (eg firefox, mutt).
16
17 3.      _NET_WM_OPACITY is set. Run xcompmgr or the like, so you can see which
18         window has focus. (Non-zero width borders are probably broken in this fork)
19
20
21 Requirements
22 ------------
23 In order to build dwm you need the Xlib header files.
24
25
26 Installation
27 ------------
28 Edit config.mk to match your local setup (dwm is installed into
29 the /usr/local namespace by default).
30
31 Afterwards enter the following command to build and install dwm (if
32 necessary as root):
33
34     make clean install
35
36 If you are going to use the default bluegray color scheme it is highly
37 recommended to also install the bluegray files shipped in the dextra package.
38
39
40 Running dwm
41 -----------
42 Add the following line to your .xinitrc to start dwm using startx:
43
44     exec dwm
45
46 In order to connect dwm to a specific display, make sure that
47 the DISPLAY environment variable is set correctly, e.g.:
48
49     DISPLAY=foo.bar:1 exec dwm
50
51 (This will start dwm on display :1 of the host foo.bar.)
52
53 In order to display status info in the bar, you can do something
54 like this in your .xinitrc:
55
56     while xsetroot -name "`date` `uptime | sed 's/.*,//'`"
57     do
58         sleep 1
59     done &
60     exec dwm
61
62
63 Configuration
64 -------------
65 The configuration of dwm is done by creating a custom config.h
66 and (re)compiling the source code.