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