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