1 .TH WMPUS 1 "June 2012" wmpus
3 wmpus \- cross platform window manager
5 .B wmpus\fR [\fIOPTION\fR..]
7 wmpus is portable window manager. Currently it supports wmii like window
8 management and includes x11 and win32 backends.
11 .B -n\fR, \fB--no-capture\fR
12 Do not arrange pre-existing windows
14 .B -b\fR, \fB--border\fR=\fIN\fR
15 Draw an n pixel window border
17 .B -m\fR, \fB--margin\fR=\fIN\fR
18 Leave an n pixel margin around windows
20 .B -i\fR, \fB--int\fR=\fIKEY=NUM\fR
21 Set integer configuration option
23 .B -s\fR, \fB--str\fR=\fIKEY=STR\fR
24 Set string configuration option
26 .B -h\fR, \fB--help\fR
27 Print usage information
29 Wmpus supports a simple ini-like configuration file stored in the users home
30 directory. Currently supported configuration options include:
33 .B no-capture\fR=\fI[01]\fR
34 Do not arrange pre-existing windows. Same as \fB-n\fR
37 Border width in pixels to draw around windows. X11 only, default 2. Same as
41 Margin in pixels between windows for wm-wmii. X11 default 0, Win32 default 15.
45 Height in pixels for non-focused windows when the column is set to stack layout
46 .SH COMPILE-TIME OPTIONS
47 The windowing system backend and window management modes can be changed at
48 compile-time by linking in the correct object file. Supported windowing systems
49 include X11 (sys-x11.c) and Windows (sys-win32.c). Supported window management
50 modes include WMII like window management (wm-wmii.c) and a simple tags based
51 virtual-desktop manager (wm-tags.c).
53 In addition several pre-processor settings are available which can be set in
54 config.mk or on the command line:
56 .B MODKEY\fR=\fIkey\fR
57 Modifier used for window management commands, can be either \fIAlt\fR,
58 \fICtrl\fR, \fIShift\fR, or \fIWin\fR. Default Alt
61 Enable various debugging functions
63 .SH WMII WINDOW MANAGEMENT
64 The wmii window management mode mimics the behavior of the \fBwmii\fR(1) window
65 manager. By default, the \fBAlt\-\fR prefix is used for most window management
66 commands and is used along with the h, j, k, and l keys to focused different
69 The \fBAlt\-Shift\-\fR prefix is used for moving windows and works similar to
70 changing the focus. The mouse is used for resizing windows and also for
75 Focus window \fIbelow\fR the currently focused window
78 Focus window \fIabove\fR the currently focused window
81 Focus column to the \fIleft\fR of the currently focused column
84 Focus column to the \fIright\fR of the currently focused column
85 .SS Moving windows around
88 Move the currently focused window \fIdown\fR
91 Move the currently focused window \fIup\fR
94 Move the currently focused window to the \fIleft\fR
97 Move the currently focused window to the \fIright\fR
101 Switch the current column to \fIsplit\fR layout
104 Switch the current to \fIstack\fR layout
107 Switch the current to \fImaximized\fR layout
113 .B Alt\-Shift\-[0..n]
114 Move the currently focused window to tag n
118 Toggle focus between the tiling and floating layers
121 Move the currently focused window between the tiling and floating layers
125 Toggle fullscreen for the focused window
128 Close the currently focused window
131 Restore all hidden windows and quit wmpus
134 Refresh the window layout (useful for debugging)
137 Dump a ASCII representation the window layout to standard output (useful for
142 Moving the mouse over a window focuses that window
145 Click in a floating window brings it to the top
148 Click and drag moves a floating window under the cursor
150 .B Alt-Button3, Alt-Shift-Button1
151 Click and drag resizes the window under the cursor
153 The X11 backend draws a small 2px border around each window. The border for the
154 currently focused window is set to a lighter color than the rest.
156 The Win32 backend uses the existing window borders and title bars. It also
157 leaves a narrow space between the windows so that they look more natural in a
162 The wmpus configuration file