README
author arg@10ksloc.org
Wed, 02 Aug 2006 16:46:59 +0200
changeset 166 e0535db04dfe
parent 154 a011f447af88
child 170 697715541a25
permissions -rw-r--r--
removed the CONFIG variable from config.mk, renamed config.h into config.default.h, after first clone/extract one needs to copy config.default.h to config.h, that is easier than always heavy typing make CONFIG=blafasel
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
eb14fb2c0ee0 small changes to README
Anselm R. Garbe <garbeam@wmii.de>
parents: 34
diff changeset
     2
----------------------------
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
     3
dwm is an extremely fast, small, and dynamic X11 window manager.
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
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
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
166
e0535db04dfe removed the CONFIG variable from config.mk, renamed config.h into config.default.h, after first clone/extract one needs to copy config.default.h to config.h, that is easier than always heavy typing make CONFIG=blafasel
arg@10ksloc.org
parents: 154
diff changeset
    19
    cp config.default.h config.h
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    20
    make clean install
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    21
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    22
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    23
Running dwm
37
eb14fb2c0ee0 small changes to README
Anselm R. Garbe <garbeam@wmii.de>
parents: 34
diff changeset
    24
-----------
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    25
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
    26
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    27
    exec dwm
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
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
    30
the DISPLAY environment variable is set correctly, e.g.:
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    31
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    32
    DISPLAY=foo.bar:1 exec dwm
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    33
154
a011f447af88 simplified README
arg@10ksloc.org
parents: 146
diff changeset
    34
(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
    35
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    36
In order to display status info in the bar, you can do something
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    37
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
    38
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    39
    while true
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    40
    do
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    41
        echo `date` `uptime | sed 's/.*://; s/,//g'`
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    42
        sleep 1
135
a4305fb0cfac changed the status info README hint (more simple now, no extra script necessary)
arg@10ksloc.org
parents: 132
diff changeset
    43
    done | dwm
132
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    44
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    45
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    46
Configuration
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    47
-------------
146
f328ce9c558c centralized/externalized configuration to config.h
arg@10ksloc.org
parents: 143
diff changeset
    48
The configuration of dwm is done by editing config.h.