Adding a `.gitignore` file to ignore vim swap files.
[dwm] / README
CommitLineData
7b563492
AT
1This git repository contains my personal branch of dwm-6.4.
2
3The changes made to stock dwm add the following abilities.
4
8f6a31e7
AT
5 - Draw per-client indicators in the tag section of the status bar.
6 <https://dwm.suckless.org/patches/clientindicators/>
7
1da78b82
AT
8 - Prompt the user before exiting/restarting dwm.
9 <https://dwm.suckless.org/patches/quitprompt/>
10
c56e7560
AT
11 - Assign text names to tags at runtime.
12 <https://dwm.suckless.org/patches/nametag/>
13
14 - Layout menu popup presents available layouts.
15 <https://dwm.suckless.org/patches/layoutmenu/>
7b563492
AT
16
17 - Select multiple tags for simultaneous display or window assignment.
18 <https://dwm.suckless.org/patches/combo/>
19
20 - Deselect ALL tags, displaying an empty desktop.
21 <https://dwm.suckless.org/patches/emptyview/>
22
23 - Center window names in status bar.
24 <https://dwm.suckless.org/patches/centeredwindowname/>
25
853da249
AT
26 - Active client has wide, red border.
27
d9c1cfe3
AT
28 - Customized rules/keybindings in `config.h`.
29
c56e7560
AT
30In addition to the usual dependencies and installation tasks for dwm (see the
31original README at the bottom of this file), there are the following new
32dependencies/tasks.
7b563492
AT
33
34 - xmenu from <https://github.com/phillbush/xmenu>. This requires freetype2
35 and imlib2, available in FreeBSD's ports collection under `print/freetype2`
c56e7560 36 and `graphics/imlib2`. This is required for the layout menu popup.
7b563492 37
c56e7560 38 - Customize (if needed) and install `layoutmenu.sh` somewhere in your `$PATH`.
a4f2fca0 39 Remember to make it executable.
7b563492 40
c41cac64
AT
41 - Build and install SGK version of dwmstatus, then call from `.xinitrc`.
42
7b563492
AT
43================================================================================
44================================================================================
45================================================================================
46
47Below is the original dwm README file.
48
49================================================================================
50================================================================================
51================================================================================
52
53
5715edf5
AT
54dwm - dynamic window manager
55============================
56dwm is an extremely fast, small, and dynamic window manager for X.
57
58
59Requirements
60------------
61In order to build dwm you need the Xlib header files.
62
63
64Installation
65------------
66Edit config.mk to match your local setup (dwm is installed into
67the /usr/local namespace by default).
68
69Afterwards enter the following command to build and install dwm (if
70necessary as root):
71
72 make clean install
73
74
75Running dwm
76-----------
77Add the following line to your .xinitrc to start dwm using startx:
78
79 exec dwm
80
81In order to connect dwm to a specific display, make sure that
82the DISPLAY environment variable is set correctly, e.g.:
83
84 DISPLAY=foo.bar:1 exec dwm
85
86(This will start dwm on display :1 of the host foo.bar.)
87
88In order to display status info in the bar, you can do something
89like this in your .xinitrc:
90
91 while xsetroot -name "`date` `uptime | sed 's/.*,//'`"
92 do
93 sleep 1
94 done &
95 exec dwm
96
97
98Configuration
99-------------
100The configuration of dwm is done by creating a custom config.h
101and (re)compiling the source code.