3 .\" Copyright (c) 2009 Marco Peereboom <marco@peereboom.us>
5 .\" Permission to use, copy, modify, and distribute this software for any
6 .\" purpose with or without fee is hereby granted, provided that the above
7 .\" copyright notice and this permission notice appear in all copies.
9 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
22 .Nd window manager for X11
27 is a minimalistic window manager that tries to stay out of the way so that
28 valuable screen real estate can be used for much more important stuff.
29 It has sane defaults and does not require one to learn a language to do any
31 It was written by hackers for hackers and it strives to be small, compact and
36 starts up, it reads settings from its configuration file,
39 .Sx CONFIGURATION FILES
42 The following notation is used throughout this page:
44 .Bl -tag -width Ds -offset indent -compact
58 is very simple in its use.
59 Most of the actions are initiated via keybindings.
60 The current keybindings are described below:
62 .Bl -tag -width "M-j, M-<TAB>XXX" -offset indent -compact
63 .It Cm M-S- Ns Aq Cm Return
72 .It Cm M- Ns Aq Cm Space
74 .It Cm M-S- Ns Aq Cm Space
81 Add windows to master area
83 Remove windows from master area
84 .It Cm M- Ns Aq Cm Return
85 Move current window to master area
90 Focus next window in workspace
95 Focus previous window in workspace
97 Focus on main window in workspace
99 Swap with next window in workspace
101 Swap with previous window in workspace
103 Toggle status bar in all workspaces
105 Destroy current window in workspace
109 .It Cm M-S- Ns Aq Ar n
110 Move current window to workspace
112 .It Cm M- Ns Aq Cm Right
113 Switch to next workspace with a window in it
114 .It Cm M- Ns Aq Cm Left
115 Switch to previous workspace with a window in it
116 .It Cm M-S- Ns Aq Cm Right
117 Move pointer to next region
118 .It Cm M-S- Ns Aq Cm Left
119 Move pointer to previous region
121 Take screenshot of entire screen (if enabled)
123 Take screenshot of selected window (if enabled)
125 Toggle version in status bar
127 Toggle focused window between tiled and floating
128 .It Cm M-S Aq Cm Delete
137 Resize window while maintaining it centered
139 .Sh CONFIGURATION FILES
141 first tries to open the user specific file,
142 .Pa ~/.scrotwm.conf .
143 If that file is unavailable,
144 it then tries to open the global configuration file
145 .Pa /etc/scrotwm.conf .
147 The format of the file is \*(Ltkeyword\*(Gt = \*(Ltsetting\*(Gt.
150 .Dl color_focus = red
152 Enabling or disabling an option is done by using 1 or 0 respectively.
154 The file supports the following keywords:
156 .Bl -tag -width "screenshot_enabledXXX" -offset indent -compact
158 Border color of the currently focussed window.
160 Border color of unfocussed windows.
162 Enable or disable status bar.
163 .It Cm bar_border Ns Bq Ar x
164 Color of the status bar border in screen
166 .It Cm bar_color Ns Bq Ar x
167 Color of the status bar window in screen
169 .It Cm bar_font_color Ns Bq Ar x
170 Color of the font in status bar in screen
175 External script that populates additional information in the status bar,
176 such as battery life.
178 Update frequency, in seconds, of external script that populates the status bar.
180 External application that gets spawned when
181 .Cm M-S- Ns Aq Cm Return
184 Some applications have dialogue windows that are too small to be useful.
185 This ratio is the screen size to what they will be resized.
186 For example, 0.6 is 60% of the physical screen size.
187 .It Cm screenshot_enabled
188 Enable or disable screenshot capability.
189 .It Cm screenshot_app
190 Set to the script that will take screenshots.
191 It will be called with "full" or "window" as parameter 1 to indicate what
192 screenshot action is expected.
193 The script shall handle those cases accordingly.
196 Colors need to be specified per the
198 specification and fonts need to be specified per the
202 .Bl -tag -width "/etc/scrotwm.confXXX" -compact
203 .It Pa ~/.scrotwm.conf
205 user specific settings.
206 .It Pa /etc/scrotwm.conf
212 was inspired by xmonad & dwm.
218 .An Marco Peereboom Aq marco@peereboom.us
220 .An Ryan Thomas McBride Aq mcbride@countersiege.com .
222 Currently the menu, invoked with