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