1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
4 <title>~/scrotwm.~.html</title>
5 <meta name="Generator" content="Vim/7.2">
6 <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
8 <body text="#ffffff" bgcolor="#000000"><font face="monospace">
9 <font color="#ff40ff">SCROTWM(1) OpenBSD Reference Manual SCROTWM(1)</font><br>
11 <font color="#ffff00">NAME</font><br>
12 scrotwm - small dynamic tiling window manager for X11.<br>
14 <font color="#ffff00">SYNOPSIS</font><br>
15 scrotwm<br>
17 <font color="#ffff00">DESCRIPTION</font><br>
18 scrotwm is a minimalistic window manager that tries to stay out of the<br>
19 way so that valuable screen real estate can be used for much more impor-<br>
20 tant stuff. It has sane defaults and does not require one to learn a<br>
21 language to do any configuration. It was written by hackers for hackers<br>
22 and it strives to be small, compact and fast.<br>
24 The following notation is used throughout this page:<br>
26 M Meta<br>
27 S Shift<br>
28 [Name] Named key<br>
29 M1 Mouse button 1<br>
31 scrotwm is very simple in its use. Most of the actions are initiated via<br>
32 keybindings. The current keybindings are described below:<br>
34 M-S-[Return] Spawn a new terminal.<br>
35 M-p Menu.<br>
36 M-S-q Quit.<br>
37 M-q Restart scrotwm.<br>
38 M-[Space] Cycle layout.<br>
39 M-S-[Space] Reset layout.<br>
40 M-h Shrink master area.<br>
41 M-l Grow master area.<br>
42 M-, Add windows to master area.<br>
43 M-. Remove windows from master area.<br>
44 M-[Return] Move current window to master area.<br>
45 M-j Focus next window in workspace.<br>
46 M-[Tab] Focus next window in workspace.<br>
47 M-k Focus previous window in workspace.<br>
48 M-S-[Tab] Focus previous window in workspace.<br>
49 M-m Focus on main window in workspace.<br>
50 M-S-j Swap with next window in workspace.<br>
51 M-S-k Swap with previous window in workspace.<br>
52 M-b Toggle status bar in all workspaces.<br>
53 M-S-x Destroy current window in workspace.<br>
54 M-[Number] Switch to workspace [Number].<br>
55 M-S-[Number] Move current window to workspace [Number].<br>
56 M-[RighArrow] Switch to next workspace with a window in it.<br>
57 M-[LeftArrow] Switch to previous workspace with a window in it.<br>
58 M-s Take screenshot of entire screen (if enabled).<br>
59 M-S-s Take screenshot of selected window (if enabled).<br>
60 M1 Focus window.<br>
62 <font color="#ffff00">FILES</font><br>
63 ~/.scrotwm.conf<br>
64 This file contains user specific settings.<br>
66 /etc/scrotwm.conf<br>
67 This file contains global settings.<br>
69 scrotwm first tries to open the user specific file. If that file is un-<br>
70 available it tries to open the global file next.<br>
72 The format of the file is <keyword> = <setting>. E.g. color_focus = red.<br>
74 The file supports the following keywords:<br>
75 color_focus Border color of the currently focussed window.<br>
76 color_unfocus Border color of unfocussed windows.<br>
77 bar_enabled Enable or disable status bar.<br>
78 bar_border[x] Color of the status bar border in screen x.<br>
79 bar_color[x] Color of the status bar window in screen x.<br>
80 bar_font_color[x]<br>
81 Color of the font in status bar in screen x.<br>
82 bar_font Status bar font.<br>
83 bar_action External script to populate additional information<br>
84 in the status bar such as battery life etc.<br>
85 bar_delay Update frequency of external script on the status<br>
86 bar.<br>
87 spawn_term External application that gets spawned when M-S-[Re-<br>
88 turn] is used.<br>
89 dialog_ratio Some applications have dialog windows that are too<br>
90 small to be useful. This ratio is the screen size<br>
91 as to what they will be resized. E.g 0.6 is 60% of<br>
92 the physical screen size.<br>
93 screenshot_enabled<br>
94 Set to 1 to enable screen-shotting capability.<br>
96 Colors need to be specified per the <font color="#ff40ff">XQueryColor(4)</font> specification and<br>
97 fonts need to be specified per the <font color="#ff40ff">XQueryFont(4)</font> specification.<br>
99 <font color="#ffff00">BUGS</font><br>
100 Currently the menu, invoked with M-p, depends on dmenu.<br>
102 <font color="#ffff00">AUTHORS</font><br>
103 scrotwm was written by Marco Peereboom <marco@peereboom.us> and Ryan<br>
104 Thomas McBride <mcbride@countersiege.com>.<br>
106 <font color="#ffff00">HISTORY</font><br>
107 scrotwm was inspired by xmonad & dwm.<br>
109 scrotwm first appeared in OpenBSD 4.5.<br>
111 OpenBSD 4.4 January 25, 2009 2<br>