README
author Stiletto <blasux@blasux.ru>
Wed, 15 Jun 2011 11:35:51 +0400
branchstil
changeset 1535 d815765dfc53
parent 1375 9bd33197840f
child 1539 e2a9bd720b6e
permissions -rw-r--r--
pushup/pushdown formatting in default config
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.