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