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,2]
40click on a tag label focuses that
41.B tag.
42.TP
43.B Button3
44click on a tag label toggles that
45.B tag.
46.SS Keyboard commands
47.TP
48.B Mod1-Return
49Zoom current
50.B window
51to the
52.B master
53column.
54.TP
55.B Mod1-j
56Focus next
57.B window.
58.TP
59.B Mod1-k
60Focus previous
61.B window.
62.TP
63.B Mod1-m
64Maximize current
65.B window.
66.TP
67.B Mod1-[0..n]
68Focus
69.B nth tag.
70.TP
71.B Mod1-space
72Toggle between
73.B tiled
74and
75.B floating
76mode (affects
77.BR "all windows" ).
78.TP
79.B Mod1-Shift-[0..n]
80Apply
81.B nth tag
82to current
83.B window.
84.TP
85.B Mod1-Shift-c
86Close focused
87.B window.
88.TP
89.B Mod1-Shift-q
90Quit
91.B dwm.
92.TP
93.B Mod1-Shift-Return
94Start
95.B terminal.
96.TP
97.B Mod1-Control-[0..n]
98Toggle
99.B nth tag.
100.TP
101.B Mod1-Control-Shift-[0..n]
102Append
103.B nth tag
104to current
105.B window.
106.SS Mouse commands
107.TP
108.B Mod1-Button1
109Move current
110.B window
111while dragging.
112.TP
113.B Mod1-Button2
114Zoom current
115.B window
116to the
117.B master
118column.
119.TP
120.B Mod1-Button3
121Resize current
122.B window
123while dragging.
124.SH CUSTOMIZATION
125.B dwm
126is customized by creating a custom config.h and (re)compiling the source
127code. This keeps it fast, secure and simple.
128.SH CAVEATS
129The status bar displays
130.BR "broken pipe"
131when
132.B dwm
133has been started by
134.BR xdm (1),
135because it closes standard output before executing
136.B dwm.
137.SH SEE ALSO
138.BR dmenu (1)