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 mode
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 mode
104 Switch the current to \fIstack\fR mode
107 Switch the current to \fImaximized\fR mode
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 Close the currently focused window
128 Restore all hidden windows and quit wmpus
131 Refresh the window layout (useful for debugging)
134 Dump a ASCII representation the window layout to standard output (useful for
139 Moving the mouse over a window focuses that window
142 Click in a floating window brings it to the top
145 Click and drag moves a floating window under the cursor
148 Click and drag resizes the window under the cursor
150 The X11 backend draws a small 2px border around each window. The border for the
151 currently focused window is set to a lighter color than the rest.
153 The Win32 backend uses the existing window borders and title bars. It also
154 leaves a narrow space between the windows so that they look more natural in a
159 The wmpus configuration file