Added patch to draw per-client indicators over the tag section of the status bar.
[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
c56e7560
AT
26In addition to the usual dependencies and installation tasks for dwm (see the
27original README at the bottom of this file), there are the following new
28dependencies/tasks.
7b563492
AT
29
30 - xmenu from <https://github.com/phillbush/xmenu>. This requires freetype2
31 and imlib2, available in FreeBSD's ports collection under `print/freetype2`
c56e7560 32 and `graphics/imlib2`. This is required for the layout menu popup.
7b563492 33
c56e7560 34 - Customize (if needed) and install `layoutmenu.sh` somewhere in your `$PATH`.
a4f2fca0 35 Remember to make it executable.
7b563492
AT
36
37================================================================================
38================================================================================
39================================================================================
40
41Below is the original dwm README file.
42
43================================================================================
44================================================================================
45================================================================================
46
47
5715edf5
AT
48dwm - dynamic window manager
49============================
50dwm is an extremely fast, small, and dynamic window manager for X.
51
52
53Requirements
54------------
55In order to build dwm you need the Xlib header files.
56
57
58Installation
59------------
60Edit config.mk to match your local setup (dwm is installed into
61the /usr/local namespace by default).
62
63Afterwards enter the following command to build and install dwm (if
64necessary as root):
65
66 make clean install
67
68
69Running dwm
70-----------
71Add the following line to your .xinitrc to start dwm using startx:
72
73 exec dwm
74
75In order to connect dwm to a specific display, make sure that
76the DISPLAY environment variable is set correctly, e.g.:
77
78 DISPLAY=foo.bar:1 exec dwm
79
80(This will start dwm on display :1 of the host foo.bar.)
81
82In order to display status info in the bar, you can do something
83like this in your .xinitrc:
84
85 while xsetroot -name "`date` `uptime | sed 's/.*,//'`"
86 do
87 sleep 1
88 done &
89 exec dwm
90
91
92Configuration
93-------------
94The configuration of dwm is done by creating a custom config.h
95and (re)compiling the source code.