aboutsummaryrefslogtreecommitdiff
path: root/README.adoc
blob: 8a2fdeae7d7c4f991eee6f7d065cf610ab6ef5db (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
61
62
63
64
65
66
67
= davidpkj’s dynamic window manager

https://dwm.suckless.org/dwm[dwm] is a dynamic window manager for https://www.x.org/wiki/[X] which sucks less.

Added feautres:

- Center title
- Layout cycling (tiled, tabbed, floating)
- Xresources utilization
- XF86 Keys utilization
- Always-on-top functionality
- Sticky windows functionality
- Swallowing terminals functionality
- Gaps everywhere
- Inner status bar padding
- Tags have own layouts
- Fancy and functional tabbed bar
- Movable child windows

== Requirements

In order to build dwm you need the Xlib header files.

== 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):

```bash
make clean install
```

== Running dwm

Add the following line to your .xinitrc to start dwm using startx:

```bash
exec dwm
```

In order to connect dwm to a specific display, make sure that
the DISPLAY environment variable is set correctly, e.g.:

```bash
DISPLAY=foo.bar:1 exec dwm
```

(This will start dwm on display :1 of the host foo.bar.)

In order to display status info in the bar, you can do something
like this in your .xinitrc:

```bash
while xsetroot -name "`date` `uptime | sed 's/.*,//'`"
do
  sleep 1
done &
exec dwm
```

== Configuration

The configuration of dwm is done by creating a custom config.h
and (re)compiling the source code.