Updated README to reflect the last few commits.
[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
5 -
6
7 - Select multiple tags for simultaneous display or window assignment.
8 <https://dwm.suckless.org/patches/combo/>
9
10 - Deselect ALL tags, displaying an empty desktop.
11 <https://dwm.suckless.org/patches/emptyview/>
12
13 - Center window names in status bar.
14 <https://dwm.suckless.org/patches/centeredwindowname/>
15
16In addition to the usual dependencies for dwm (see the original README at the
17bottom of this file), there are the following new dependencies.
18
19 - xmenu from <https://github.com/phillbush/xmenu>. This requires freetype2
20 and imlib2, available in FreeBSD's ports collection under `print/freetype2`
21 and `graphics/imlib2`.
22
23
24
25================================================================================
26================================================================================
27================================================================================
28
29Below is the original dwm README file.
30
31================================================================================
32================================================================================
33================================================================================
34
35
5715edf5
AT
36dwm - dynamic window manager
37============================
38dwm is an extremely fast, small, and dynamic window manager for X.
39
40
41Requirements
42------------
43In order to build dwm you need the Xlib header files.
44
45
46Installation
47------------
48Edit config.mk to match your local setup (dwm is installed into
49the /usr/local namespace by default).
50
51Afterwards enter the following command to build and install dwm (if
52necessary as root):
53
54 make clean install
55
56
57Running dwm
58-----------
59Add the following line to your .xinitrc to start dwm using startx:
60
61 exec dwm
62
63In order to connect dwm to a specific display, make sure that
64the DISPLAY environment variable is set correctly, e.g.:
65
66 DISPLAY=foo.bar:1 exec dwm
67
68(This will start dwm on display :1 of the host foo.bar.)
69
70In order to display status info in the bar, you can do something
71like this in your .xinitrc:
72
73 while xsetroot -name "`date` `uptime | sed 's/.*,//'`"
74 do
75 sleep 1
76 done &
77 exec dwm
78
79
80Configuration
81-------------
82The configuration of dwm is done by creating a custom config.h
83and (re)compiling the source code.