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 small dynamic tiling 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
34 The following notation is used throughout this page:
36 .Bl -tag -width Ds -offset indent -compact
48 is very simple in its use.
49 Most of the actions are initiated via keybindings.
50 The current keybindings are described below:
52 .Bl -tag -width "C-M-EscapeXXX" -offset indent -compact
71 Add windows to master area.
73 Remove windows from master area.
75 Move current window to master area.
77 Focus next window in workspace.
79 Focus next window in workspace.
81 Focus previous window in workspace.
83 Focus previous window in workspace.
85 Focus on main window in workspace.
87 Swap with next window in workspace.
89 Swap with previous window in workspace.
91 Toggle status bar in all workspaces.
93 Destroy current window in workspace.
95 Switch to workspace [Number].
97 Move current window to workspace [Number].
99 Switch to next workspace with a window in it.
101 Switch to previous workspace with a window in it.
103 Take screenshot of entire screen (if enabled).
105 Take screenshot of selected window (if enabled).
113 .It Pa ~/.scrotwm.conf
114 This file contains user specific settings.
115 .It Pa /etc/scrotwm.conf
116 This file contains global settings.
120 first tries to open the user specific file.
121 If that file is unavailable it tries to open the global file next.
123 The format of the file is <keyword> = <setting>.
124 E.g. color_focus = red.
126 Enabling or disabling an option is done by using 1 or 0 respectively.
128 The file supports the following keywords:
129 .Bl -tag -width "C-M-EscapeXXX" -offset indent -compact
131 Border color of the currently focussed window.
133 Border color of unfocussed windows.
135 Enable or disable status bar.
137 Color of the status bar border in screen x.
139 Color of the status bar window in screen x.
140 .It Ic bar_font_color[x]
141 Color of the font in status bar in screen x.
145 External script that populates additional information in the status bar such as
148 Update frequency, in seconds, of external script that populates the status bar.
150 External application that gets spawned when M-S-[Return] is used.
152 Some applications have dialog windows that are too small to be useful.
153 This ratio is the screen size as to what they will be resized.
154 E.g 0.6 is 60% of the physical screen size.
155 .It Ic screenshot_enabled
156 Enable or disable screenshot capability.
157 .It Ic screenshot_app
158 Set to the script that will take screenshots.
159 It will be called with "full" or "window" as parameter 1 to indicate what
160 screenshot action is expected.
161 The script shall handle those cases accordingly.
164 Colors need to be specified per the
166 specification and fonts need to be specified per the
170 Currently the menu, invoked with M-p, depends on dmenu.
176 .An Marco Peereboom Aq marco@peereboom.us
178 .An Ryan Thomas McBride Aq mcbride@countersiege.com .
181 was inspired by xmonad & dwm.