README
author Anselm R Garbe <anselm@garbe.us>
Fri, 18 Sep 2009 21:18:00 +0100
changeset 1492 62a601261c8b
parent 1375 9bd33197840f
child 1539 e2a9bd720b6e
permissions -rw-r--r--
new experimental updategeom() additions that should avoid several problems with Xinerama, this is EXPERIMENTAL and might break something, the algorithms in use are quite complex and cumbersome, patches and comments welcome
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
37
eb14fb2c0ee0 small changes to README
Anselm R. Garbe <garbeam@wmii.de>
parents: 34
diff changeset
     1
dwm - dynamic window manager
497
4dbdb61c8b8c updated README
arg@mmvi
parents: 316
diff changeset
     2
============================
316
d69cdb180a3e small changes to dwm.1, rearranged order within main event loop
Anselm R.Garbe <arg@10ksloc.org>
parents: 174
diff changeset
     3
dwm is an extremely fast, small, and dynamic window manager for X.
17
aaf520f53110 updated README
Anselm R. Garbe <garbeam@wmii.de>
parents: 9
diff changeset
     4
aaf520f53110 updated README
Anselm R. Garbe <garbeam@wmii.de>
parents: 9
diff changeset
     5
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     6
Requirements
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     7
------------
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
     8
In order to build dwm you need the Xlib header files.
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
     9
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    10
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    11
Installation
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    12
------------
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    13
Edit config.mk to match your local setup (dwm is installed into
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    14
the /usr/local namespace by default).
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    15
172
af781faa40d6 implemented the idea presented by Sander for dwm target
arg@10ksloc.org
parents: 170
diff changeset
    16
Afterwards enter the following command to build and install dwm (if
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    17
necessary as root):
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    18
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    19
    make clean install
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    20
1021
b385ba02e179 added hint for downloading dextra
Anselm R. Garbe <garbeam@gmail.com>
parents: 503
diff changeset
    21
If you are going to use the default bluegray color scheme it is highly
b385ba02e179 added hint for downloading dextra
Anselm R. Garbe <garbeam@gmail.com>
parents: 503
diff changeset
    22
recommended to also install the bluegray files shipped in the dextra package.
b385ba02e179 added hint for downloading dextra
Anselm R. Garbe <garbeam@gmail.com>
parents: 503
diff changeset
    23
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    24
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    25
Running dwm
37
eb14fb2c0ee0 small changes to README
Anselm R. Garbe <garbeam@wmii.de>
parents: 34
diff changeset
    26
-----------
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    27
Add the following line to your .xinitrc to start dwm using startx:
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    28
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    29
    exec dwm
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    30
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    31
In order to connect dwm to a specific display, make sure that
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    32
the DISPLAY environment variable is set correctly, e.g.:
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    33
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    34
    DISPLAY=foo.bar:1 exec dwm
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    35
154
a011f447af88 simplified README
arg@10ksloc.org
parents: 146
diff changeset
    36
(This will start dwm on display :1 of the host foo.bar.)
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    37
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    38
In order to display status info in the bar, you can do something
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    39
like this in your .xinitrc:
132
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    40
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    41
    while true
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    42
    do
1370
6d6ed7a9183c applied Neale Pickett's xprop status reading patch, updated README and dwm.1 accordingly
a@null
parents: 1021
diff changeset
    43
        xsetroot -name "`date` `uptime | sed 's/.*,//'`"
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    44
        sleep 1
1375
9bd33197840f made status script example of .xinitrc more useful
a@null
parents: 1371
diff changeset
    45
    done &
9bd33197840f made status script example of .xinitrc more useful
a@null
parents: 1371
diff changeset
    46
    exec dwm
132
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    47
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    48
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    49
Configuration
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    50
-------------
174
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 172
diff changeset
    51
The configuration of dwm is done by creating a custom config.h
48c820470858 applied Sanders doc changes, added a PHONY line and changed the output of config.h creation somewhat
arg@10ksloc.org
parents: 172
diff changeset
    52
and (re)compiling the source code.