README
author Anselm R. Garbe <arg@10kloc.org>
Tue, 29 Aug 2006 17:31:55 +0200
changeset 384 126e78129f1d
parent 316 d69cdb180a3e
child 497 4dbdb61c8b8c
permissions -rw-r--r--
configurenotify remembers max geom now, and restores this if necessary, however it accepts to touch the max size on configurerequest, this shouldn't break fillscreen apps (tested with mplayer)
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
----------------------------
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
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    21
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    22
Running dwm
37
eb14fb2c0ee0 small changes to README
Anselm R. Garbe <garbeam@wmii.de>
parents: 34
diff changeset
    23
-----------
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    24
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
    25
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    26
    exec dwm
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    27
34
cd30cce52b78 added logo+description
Anselm R. Garbe <garbeam@wmii.de>
parents: 32
diff changeset
    28
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
    29
the DISPLAY environment variable is set correctly, e.g.:
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
    DISPLAY=foo.bar:1 exec dwm
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    32
154
a011f447af88 simplified README
arg@10ksloc.org
parents: 146
diff changeset
    33
(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
    34
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    35
In order to display status info in the bar, you can do something
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    36
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
    37
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    38
    while true
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    39
    do
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    40
        echo `date` `uptime | sed 's/.*://; s/,//g'`
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    41
        sleep 1
135
a4305fb0cfac changed the status info README hint (more simple now, no extra script necessary)
arg@10ksloc.org
parents: 132
diff changeset
    42
    done | dwm
132
59e997ca04a6 added a note how to achieve status info in the bar
arg@10ksloc.org
parents: 87
diff changeset
    43
143
36cabfe408cd applied Sanders patches
arg@10ksloc.org
parents: 136
diff changeset
    44
0
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    45
Configuration
491f34c11291 initial import
Anselm R. Garbe <garbeam@wmii.de>
parents:
diff changeset
    46
-------------
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
    47
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
    48
and (re)compiling the source code.