3 dwm \- dynamic window manager |
3 dwm \- dynamic window manager |
4 .SH SYNOPSIS |
4 .SH SYNOPSIS |
5 .B dwm |
5 .B dwm |
6 .RB [ \-v ] |
6 .RB [ \-v ] |
7 .SH DESCRIPTION |
7 .SH DESCRIPTION |
8 .B dwm |
8 dwm is a dynamic window manager for X. It manages windows in tiling and |
9 is a dynamic window manager for X. It manages windows in tiling and floating |
9 floating modes. Either mode can be applied dynamically, optimizing the |
10 modes. Either mode can be applied dynamically, optimizing the environment for |
10 environment for the application in use and the task performed. |
11 the application in use and the task performed. |
|
12 .P |
11 .P |
13 In tiling mode windows are managed in a master and stacking column. The master |
12 In tiling mode windows are managed in a master and stacking column. The master |
14 column contains the window which currently needs most attention, whereas the |
13 column contains the window which currently needs most attention, whereas the |
15 stacking column contains all other windows. In floating mode windows can be |
14 stacking column contains all other windows. In floating mode windows can be |
16 resized and moved freely. Dialog windows are always managed floating, |
15 resized and moved freely. Dialog windows are always managed floating, |
17 regardless of the mode selected. |
16 regardless of the mode selected. |
18 .P |
17 .P |
19 Windows are grouped by tags. Each window can be tagged with one or multiple |
18 Windows are grouped by tags. Each window can be tagged with one or multiple |
20 tags. Selecting certain tags for viewing will display all windows with that tag. |
19 tags. Selecting certain tags for viewing will display all windows with that |
|
20 tag. |
21 .P |
21 .P |
22 .B dwm |
22 dwm contains a small status bar which displays all available tags, the mode, |
23 contains a small status bar which displays all available tags, the mode, the |
23 the title of the focused window, and the text read from standard input. The |
24 title of the focused window, and the text read from standard input. The |
|
25 selected tags are highlighted with a different color, the tags of the focused |
24 selected tags are highlighted with a different color, the tags of the focused |
26 window are highlighted with a small point. |
25 window are highlighted with a small point. |
27 .P |
26 .P |
28 .B dwm |
27 dwm draws a 1-pixel border around windows to indicate the focus state. |
29 draws a 1-pixel border around windows to indicate the focus state. |
|
30 Unfocused windows contain a small bar in front of them displaying their title. |
28 Unfocused windows contain a small bar in front of them displaying their title. |
31 .SH OPTIONS |
29 .SH OPTIONS |
32 .TP |
30 .TP |
33 .B \-v |
31 .B \-v |
34 prints version information to standard output, then exits. |
32 prints version information to standard output, then exits. |
37 .TP |
35 .TP |
38 .B Standard input |
36 .B Standard input |
39 is read and displayed in the status text area. |
37 is read and displayed in the status text area. |
40 .TP |
38 .TP |
41 .B Button1 |
39 .B Button1 |
42 click on a tag label views all windows with that |
40 click on a tag label views all windows with that tag, click on the mode label |
43 .BR tag , |
41 toggles between tiled and floating mode. |
44 click on the mode label toggles between |
|
45 .B tiled |
|
46 and |
|
47 .B floating |
|
48 mode. |
|
49 .TP |
42 .TP |
50 .B Button3 |
43 .B Button3 |
51 click on a tag label adds/removes all windows with that |
44 click on a tag label adds/removes all windows with that tag to/from the view. |
52 .B tag |
|
53 to/from the view. |
|
54 .TP |
45 .TP |
55 .B Mod1-Button1 |
46 .B Mod1-Button1 |
56 click on a tag label applies that |
47 click on a tag label applies that tag to the focused window. |
57 .B tag |
|
58 to the focused |
|
59 .BR window . |
|
60 .TP |
48 .TP |
61 .B Mod1-Button3 |
49 .B Mod1-Button3 |
62 click on a tag label adds/removes that |
50 click on a tag label adds/removes that tag to/from the focused window. |
63 .B tag |
|
64 to/from the focused |
|
65 .BR window . |
|
66 .SS Keyboard commands |
51 .SS Keyboard commands |
67 .TP |
52 .TP |
68 .B Mod1-Shift-Return |
53 .B Mod1-Shift-Return |
69 Start |
54 Start |
70 .BR xterm (1). |
55 .BR xterm (1). |
71 .TP |
56 .TP |
72 .B Mod1-Tab |
57 .B Mod1-Tab |
73 Focus next |
58 Focus next window. |
74 .BR window . |
|
75 .TP |
59 .TP |
76 .B Mod1-Shift-Tab |
60 .B Mod1-Shift-Tab |
77 Focus previous |
61 Focus previous window. |
78 .BR window . |
|
79 .TP |
62 .TP |
80 .B Mod1-Return |
63 .B Mod1-Return |
81 Zoom current |
64 Zoom current window to the master column (tiling mode only). |
82 .B window |
|
83 to the |
|
84 .B master |
|
85 column |
|
86 .RB ( tiling |
|
87 mode only). |
|
88 .TP |
65 .TP |
89 .B Mod1-m |
66 .B Mod1-m |
90 Maximize current |
67 Maximize current window. |
91 .BR window . |
|
92 .TP |
68 .TP |
93 .B Mod1-g |
69 .B Mod1-g |
94 Grow current |
70 Grow current column (tiling mode only). |
95 .BR column |
|
96 .RB ( tiling |
|
97 mode only). |
|
98 .TP |
71 .TP |
99 .B Mod1-s |
72 .B Mod1-s |
100 Shrink current |
73 Shrink current column (tiling mode only). |
101 .BR column |
|
102 .RB ( tiling |
|
103 mode only). |
|
104 .TP |
74 .TP |
105 .B Mod1-Shift-[1..n] |
75 .B Mod1-Shift-[1..n] |
106 Apply |
76 Apply |
107 .B nth tag |
77 .RB nth |
108 to current |
78 tag to current window. |
109 .BR window . |
|
110 .TP |
79 .TP |
111 .B Mod1-Control-Shift-[1..n] |
80 .B Mod1-Control-Shift-[1..n] |
112 Add/remove |
81 Add/remove |
113 .B nth tag |
82 .B nth |
114 to/from current |
83 tag to/from current window. |
115 .BR window . |
|
116 .TP |
84 .TP |
117 .B Mod1-Shift-c |
85 .B Mod1-Shift-c |
118 Close focused |
86 Close focused window. |
119 .B window. |
|
120 .TP |
87 .TP |
121 .B Mod1-space |
88 .B Mod1-space |
122 Toggle between |
89 Toggle between tiled and floating mode (affects all windows). |
123 .B tiled |
|
124 and |
|
125 .B floating |
|
126 mode (affects |
|
127 .BR "all windows" ). |
|
128 .TP |
90 .TP |
129 .B Mod1-[1..n] |
91 .B Mod1-[1..n] |
130 View all windows with |
92 View all windows with |
131 .BR "tag n" . |
93 .BR nth |
|
94 tag. |
132 .TP |
95 .TP |
133 .B Mod1-0 |
96 .B Mod1-0 |
134 View all windows with any |
97 View all windows with any tag. |
135 .BR "tag" . |
|
136 .TP |
98 .TP |
137 .B Mod1-Control-[1..n] |
99 .B Mod1-Control-[1..n] |
138 Add/remove all windows with |
100 Add/remove all windows with |
139 .B tag n |
101 .BR nth |
140 to/from the view. |
102 tag to/from the view. |
141 .TP |
103 .TP |
142 .B Mod1-Shift-q |
104 .B Mod1-Shift-q |
143 Quit |
105 Quit dwm. |
144 .B dwm. |
|
145 .SS Mouse commands |
106 .SS Mouse commands |
146 .TP |
107 .TP |
147 .B Mod1-Button1 |
108 .B Mod1-Button1 |
148 Move current |
109 Move current window while dragging (floating mode only). |
149 .B window |
|
150 while dragging |
|
151 .RB ( floating |
|
152 mode only). |
|
153 .TP |
110 .TP |
154 .B Mod1-Button2 |
111 .B Mod1-Button2 |
155 Zoom current |
112 Zoom current window to the master column (tiling mode only). |
156 .B window |
|
157 to the |
|
158 .B master |
|
159 column |
|
160 .RB ( tiling |
|
161 mode only). |
|
162 .TP |
113 .TP |
163 .B Mod1-Button3 |
114 .B Mod1-Button3 |
164 Resize current |
115 Resize current window while dragging (floating mode only). |
165 .B window |
|
166 while dragging |
|
167 .RB ( floating |
|
168 mode only). |
|
169 .SH CUSTOMIZATION |
116 .SH CUSTOMIZATION |
170 .B dwm |
117 dwm is customized by creating a custom config.h and (re)compiling the source |
171 is customized by creating a custom config.h and (re)compiling the source |
|
172 code. This keeps it fast, secure and simple. |
118 code. This keeps it fast, secure and simple. |
173 .SH CAVEATS |
119 .SH CAVEATS |
174 The status bar may display |
120 The status bar may display |
175 .B broken pipe |
121 .BR "broken pipe" |
176 when |
122 when dwm has been started by |
177 .B dwm |
|
178 has been started by |
|
179 .BR xdm (1), |
123 .BR xdm (1), |
180 because it closes standard output before executing |
124 because it closes standard output before executing dwm. |
181 .BR dwm . |
|
182 .SH SEE ALSO |
125 .SH SEE ALSO |
183 .BR dmenu (1) |
126 .BR dmenu (1) |