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