Change restart function to call SGK-modified version of dwm.
[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`.
7b563492
AT
32
33================================================================================
34================================================================================
35================================================================================
36
37Below is the original dwm README file.
38
39================================================================================
40================================================================================
41================================================================================
42
43
5715edf5
AT
44dwm - dynamic window manager
45============================
46dwm is an extremely fast, small, and dynamic window manager for X.
47
48
49Requirements
50------------
51In order to build dwm you need the Xlib header files.
52
53
54Installation
55------------
56Edit config.mk to match your local setup (dwm is installed into
57the /usr/local namespace by default).
58
59Afterwards enter the following command to build and install dwm (if
60necessary as root):
61
62 make clean install
63
64
65Running dwm
66-----------
67Add the following line to your .xinitrc to start dwm using startx:
68
69 exec dwm
70
71In order to connect dwm to a specific display, make sure that
72the DISPLAY environment variable is set correctly, e.g.:
73
74 DISPLAY=foo.bar:1 exec dwm
75
76(This will start dwm on display :1 of the host foo.bar.)
77
78In order to display status info in the bar, you can do something
79like this in your .xinitrc:
80
81 while xsetroot -name "`date` `uptime | sed 's/.*,//'`"
82 do
83 sleep 1
84 done &
85 exec dwm
86
87
88Configuration
89-------------
90The configuration of dwm is done by creating a custom config.h
91and (re)compiling the source code.