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 X. 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
24contains a small status bar which displays the text read from standard
25input. Besides that, it displays all available tags, and the title
26of the focused window.
27.P
28.B dwm draws a 1-pixel border around windows to indicate the focus state.
29Unfocused windows contain a small bar in front of them displaying their tags
30and title.
31.SH OPTIONS
32.TP
33.B \-v
34prints version information to standard output, then exits.
35.SH USAGE
36.SS Status bar
37.TP
38.B Standard input
39is read and displayed in the status text area.
40.TP
41.B Button1
42click on a tag label views all windows with that
43.BR tag .
44.TP
45.B Button3
46click on a tag label adds/removes all windows with that
47.B tag
48to/from the view.
49.SS Keyboard commands
50.TP
51.B Mod1-Shift-Return
52Start
53.BR xterm (1).
54.TP
55.B Mod1-Tab
56Focus next
57.BR window .
58.TP
59.B Mod1-Shift-Tab
60Focus previous
61.BR window .
62.TP
63.B Mod1-Return
64Zoom current
65.B window
66to the
67.B master
68column
69.RB ( tiling
70mode only).
71.TP
72.B Mod1-m
73Maximize current
74.BR window .
75.TP
76.B Mod1-Shift-[0..n]
77Apply
78.B nth tag
79to current
80.BR window .
81.TP
82.B Mod1-Control-Shift-[0..n]
83Add/remove
84.B nth tag
85to/from current
86.BR window .
87.TP
88.B Mod1-Shift-c
89Close focused
90.B window.
91.TP
92.B Mod1-space
93Toggle between
94.B tiled
95and
96.B floating
97mode (affects
98.BR "all windows" ).
99.TP
100.B Mod1-[0..n]
101View all windows with
102.BR "tag n" .
103.TP
104.B Mod1-Control-[0..n]
105Add/remove all windows with
106.B tag n
107to/from the view.
108.TP
109.B Mod1-Shift-q
110Quit
111.B dwm.
112.SS Mouse commands
113.TP
114.B Mod1-Button1
115Move current
116.B window
117while dragging
118.RB ( floating
119mode only).
120.TP
121.B Mod1-Button2
122Zoom current
123.B window
124to the
125.B master
126column
127.RB ( tiling
128mode only).
129.TP
130.B Mod1-Button3
131Resize current
132.B window
133while dragging
134.RB ( floating
135mode only).
136.SH CUSTOMIZATION
137.B dwm
138is customized by creating a custom config.h and (re)compiling the source
139code. This keeps it fast, secure and simple.
140.SH CAVEATS
141The status bar displays
142.B broken pipe
143when
144.B dwm
145has been started by
146.BR xdm (1),
147because it closes standard output before executing
148.BR dwm .
149.SH SEE ALSO
150.BR dmenu (1)