-
Notifications
You must be signed in to change notification settings - Fork 44
/
monsterwm.1
261 lines (259 loc) · 5.89 KB
/
monsterwm.1
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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
.TH MONSTERWM 1 monsterwm
.SH NAME
monsterwm \- minimal and dynamic tiling window manager
.SH SYNOPSIS
.B monsterwm
.RB [ \-v ]
.SH DESCRIPTION
.I monsterwm
is a minimal, lightweight, tiny but monstrous, dynamic tiling window manager.
.P
.SH MODES
.I monsterwm
comes with four tiling layouts by default plus the floating mode.
It allows the usual method of tiling window managers, with the new window as
the master window, but also provides the ability to have the new window opened
as the last window (at the bottom) of the stack.
.P
the available modes:
.TP
.B Tile stack
the stack clients are tiled on the side of master.
.TP
.B Bottom stack
the stack clients are tiled beneath the master.
.TP
.B Grid mode
clients are tiled in a grid, equaly sharing and dividing the screen space
.TP
.B Monocle mode
also known as fullscreen or max mode, where the clients take up the entire
screen space. Other clients are hidden behind the current shown window.
On this layout, fullscreen clients don't need and don't have borders.
You can change that behavior with the
.I monocleborders
patch, in the corresponding branch.
.TP
.B Floating mode
windows can move and be resized freely in the screen space, like on a stacking
window manager. Windows retain their floating status until the user switches
to a tiling mode.
.SH OPTIONS
.TP
.B \-v
prints version information to standard output, then exits.
.SH USAGE
.SS Status bar
.P
.I monsterwm
does not provide a status bar. Consistent with the Unix philosophy,
.I monsterwm
provides information to the status bar or panel of choice via ouputing
text with information about the state of the windows.
.P
the available settings in
.I config.h
for the panel/status bar, are:
.TP
.B SHOW_PANEL
whether the panel should be visible or hidden by default
.TP
.B TOP_PANEL
whether the panel should be on top or bottom of the screen
.TP
.B PANEL_HEIGHT
how much space should be left for use by the panel. Set to
.B 0
to disable the panel completely.
.SS Keyboard and mouse commands
All of
.I monsterwm's
commands can be customized by editing
.I config.h
and recompiling.
.P
The default keyboard-bindings include:
.TP
.B Mod1\-b
Toggles the panel on and off.
.TP
.B Mod1\-Backspace
Focus the window with an urgent hint.
Focus the appropriate desktop if needed.
.TP
.B Mod1\-Shift\-c
Close focused window.
.TP
.B Mod1\-j
Focus next window.
.TP
.B Mod1\-k
Focus previous window.
.TP
.B Mod1\-l
Increase master area size.
.TP
.B Mod1\-h
Decrease master area size.
.TP
.B Mod1\-o
Shrink the size of the first stack window.
.TP
.B Mod1\-p
Grow the size of the first stack window.
.TP
.B Mod1\-Ctrl\-h
focus the previous desktop.
.TP
.B Mod1\-Ctrl\-l
focus the next desktop.
.TP
.B Mod1\-Shift\-h
focus the previous desktop that has windows open.
.TP
.B Mod1\-Shift\-l
focus the next desktop that has windows open.
.TP
.B Mod1\-Tab
Toggles to the last selected desktop.
.TP
.B Mod1\-Return
Swaps the focused window to/from master area (tiled layouts only).
.TP
.B Mod1\-Shift\-j
Move the focussed window down the stack
.TP
.B Mod1\-Shift\-k
Move the focussed window up the stack
.TP
.B Mod1\-Shift\-t
Sets tiled layout.
.TP
.B Mod1\-Shift\-m
Sets monocle layout.
.TP
.B Mod1\-Shift\-b
Sets bottom stack layout
.TP
.B Mod1\-Shift\-g
Sets grid layout
.TP
.B Mod1\-Shift\-f
Sets float layout
.TP
.B Mod1\-Shift\-r
Quit with exit value 0 (usefull for restarts of the wm).
.TP
.B Mod1\-Shift\-q
Quit with exit value 1 (differentiate quit from restart).
.TP
.B Mod1\-Shift\-Return
Start
.BR xterm (1).
.TP
.B Mod4\-v
Start
.BR dmenu (1).
.TP
.B MOD4\-{Down,Up,Right,Left} Arrow
move the current window to the corresponding direction.
.TP
.B MOD4\-Shift\-{Down,Up,Right,Left} Arrow
resize the current window to the corresponding direction.
.TP
.B Mod1\-F{1..n}
Move to the nth workspace. By default,
.I monsterwm
is configured with four workspaces.
The setting in
.I config.h
.B FOLLOW_WINDOW
defines whether the focus should change on
the new desktop, where the window moved to.
.TP
.B Mod1\-Shift\-F{1..n}
Move focused window to nth workspace.
.P
The default mouse-bindings include:
.TP
.B Mod1\-Button1
Dragging the mouse will move the selected window
.TP
.B Mod1\-Button3
Dragging the mouse will resize the selected window
.TP
.B Mod4\-Button3
will bring up
.I dmenu
.SS Customization
.I monsterwm
is customized by copying
.I config.def.h
to
.I config.h
and (re)compiling the source code.
.P
settings among others covered above include:
.TP
.B MASTER_SIZE
set the size of the master area that
will be used by the master window
.TP
.B DEFAULT_MODE
set the default tiling mode to be active on startup
.TP
.B ATTACH_ASIDE
whether new stack clients should spawn as the master window,
or the last stack window
.TP
.B FOLLOW_MOUSE
whether to focus the window the mouse just entered
.TP
.B FOLLOW_WINDOW
whether to follow the window to the new desktop where it moved
.TP
.B CLICK_TO_FOCUS
whether an action on a window (eg clicking, or scrolling)
will give the window focus. Disabling this gives the user
the ability to, for example, look up things on a web browser
but not lose focus from the terminal etc.
.TP
.B BORDER_WIDTH
the width of the borders the windows have
.TP
.B FOCUS / UNFOCUS
the colors for the borders of focused and unfocused windows
.TP
.B DESKTOPS
the number of desktops to use
.TP
.B DEFAULT_DESKTOP
which desktop to focus by default
.TP
.B MINWSZ
the minimum window size allowed. Prevents over resizing with
the mouse or keyboard (eg resizing the master area)
.P
users can set
.B rules
on applications, by matching their
.B class
or
.B instance
name. The rules can specify on which
.B desktop
the application should start (or
.B -1
to signify the current desktop), whether the
.B focus
should change to that desktop, when the application starts
and whether the application should start on
.B floating
or tiled mode.
.SH SEE ALSO
.BR dmenu (1)
.SH BUGS
.I monsterwm
is under active development. Please report all bugs to the author.
.SH AUTHOR
Ivan c00kiemon5ter Kanakarakis <ivan.kanak at gmail.com>