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