aboutsummaryrefslogtreecommitdiff
path: root/README
blob: fa656ad6f505e5db0e9d36a2ff9f921365cf6e49 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
                     ______________________________

                      DWM - DYNAMIC WINDOW MANAGER

                                Suckless
                     ______________________________


dwm is an extremely fast, small, and dynamic window manager for X.


Requirements
============
  In order to build dwm you need the Xlib header files.  Optionally
  you will also need xinerama.

Installation
============
  Edit config.mk to match your local setup (dwm is installed into the
  /usr/local namespace by default).

  Afterwards enter the following command to build and install dwm (if
  necessary as root):
  ,----
  | make clean install
  `----

Running dwm
===========
  Add the following line to your .xinitrc to start dwm using startx:
  ,----
  | exec dwm
  `----

  In order to connect dwm to a specific display, make sure that the
  DISPLAY environment variable is set correctly.  For example, to
  start dwm on the host foo.bar on display 1:
  ,----
  | DISPLAY=foo.bar:1 exec dwm
  `----

  When hacking on the source code, it may be cumbersome to restart
  dwm.  By adding the following to your .xinitrc, one may restart dwm
  simply by killing the process, which will be immediately spawned
  again by the XServer.
  ,----
  | while :
  | do
  |     dwm
  | done
  `----
  Any applications will still exist after dwm is restarted, but may
  not laid out the same as before the restart.  Refer to the `rules`
  variable in config.h for automatic layout control.

Configuration
=============
  The configuration of dwm is done by creating a custom config.h and
  (re)compiling the source code.  Refer to dwm(1) (stored in this
  repository as well) to find more information.