aboutsummaryrefslogtreecommitdiffstats
path: root/dwm.1
blob: 56dd8b9921ed1b7cb62aa4e5e6db84f3634a528d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
.TH DWM 1 dwm-0.1
.SH NAME
dwm \- dynamic window manager
.SH SYNOPSIS
.B dwm
.RB [ \-v ]
.SH DESCRIPTION
.B dwm
is a dynamic window manager for X11. It consists of a small status bar and
arranges windows in either a tiled or floating mode.
.P
In tiled mode
.B dwm
manages all windows in a left master column and a right stacking column. The
master column contains a single window, the left stacking column all other
windows. Dialog windows are treated floating.
.P
In floating mode
.B dwm
manages all windows in a conventional way. They can be resized and moved freely
with the mouse.
.P
Windows are grouped by tags. You can view all windows with a specific tag per
time.  However, each window is allowed to contain more than one tag, which
allows to make windows visible in all views.
.P
.B dwm
reads from standard input to display status text, if written.
.P
.B dwm
draws 1-pixel borders around windows to indicate the focus state and providing as
much screen real estate as possible. Unfocused windows contain a small bar
in front of the window indicating the tags and the window title.
.SH OPTIONS
.TP
.B \-v
prints version information to standard output, then exits.
.SH CUSTOMIZATION
.B dwm
is customized through editing its source code. It is assumed that
.B dwm
users know to patch it for their needs. This keeps it fast, secure and simple,
because it does not process any input data, except window properties and
the status text read from standard input.
.SS Keyboard Control
.TP 16
.I Key	
.I Action
.TP
.B Mod1-Return
Zoom
.B window
to the 
.B master
column
.TP
.B Mod1-k
Focus previous
.B window
.TP
.B Mod1-j
Focus next
.B window
.TP
.B Mod1-m
Maximize current
.B window
.TP
.B Mod1-[0..n]
Focus
.B nth
tag
.TP
.B Mod1-space
(Re-)arrange
.B all
windows tiled
.TP
.B Mod1-Shift-space
(Re-)arrange
.B all
windows floating
.TP
.B Mod1-Shift-[0..n]
Apply
.B nth
tag to current
.B window
.TP
.B Mod1-Shift-q
Quit
.B dwm
.TP
.B Mod1-Shift-Return
Start
.B terminal
.TP
.B Mod1-Shift-w
Start
.B web browser
.TP
.B Mod1-Shift-l
Lock
.B screen
.TP
.B Control-[0..n]
Append
.B nth
tag to cureent
.B window
.SS Mouse Control
.TP
.B Mod1-Button1
Moves current
.B window
while dragging
.TP
.B Mod1-Button2
Lowers current
.B window
.TP
.B Mod1-Button3
Resizes current
.B window
while dragging
remember that computers suck.