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 - 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 When scrotwm starts up, it reads settings from its configuration file,<br>
25 scrotwm.conf. See the CONFIGURATION FILES section below.<br>
27 The following notation is used throughout this page:<br>
29 M Meta<br>
30 S Shift<br>
31 <Name> Named key<br>
32 M1 Mouse button 1<br>
33 M3 Mouse button 3<br>
35 scrotwm is very simple in its use. Most of the actions are initiated via<br>
36 key or mouse bindings. See the BINDINGS section below for defaults and<br>
37 customizations.<br>
39 <font color="#ffff00">CONFIGURATION FILES</font><br>
40 scrotwm first tries to open the user specific file, ~/.scrotwm.conf. If<br>
41 that file is unavailable, it then tries to open the global configuration<br>
42 file /etc/scrotwm.conf.<br>
44 The format of the file is <keyword> = <setting>. For example:<br>
46 color_focus = red<br>
48 Enabling or disabling an option is done by using 1 or 0 respectively.<br>
50 The file supports the following keywords:<br>
52 color_focus Border color of the currently focussed win-<br>
53 dow.<br>
54 color_unfocus Border color of unfocussed windows.<br>
55 bar_enabled Enable or disable status bar.<br>
56 bar_border[x] Color of the status bar border in screen x.<br>
57 bar_color[x] Color of the status bar window in screen x.<br>
58 bar_font_color[x] Color of the font in status bar in screen x.<br>
59 bar_font Status bar font.<br>
60 bar_action External script that populates additional<br>
61 information in the status bar, such as bat-<br>
62 tery life.<br>
63 bar_delay Update frequency, in seconds, of external<br>
64 script that populates the status bar.<br>
65 clock_enabled Enable or disable displaying the clock in<br>
66 the status bar. Disable by setting to 0 so<br>
67 a custom clock could be used in the bar_ac-<br>
68 tion script.<br>
69 spawn_term External application that gets spawned when<br>
70 M-S-<Return> is used.<br>
71 dialog_ratio Some applications have dialogue windows that<br>
72 are too small to be useful. This ratio is<br>
73 the screen size to what they will be re-<br>
74 sized. For example, 0.6 is 60% of the phys-<br>
75 ical screen size.<br>
76 region Allocates a custom region, removing any au-<br>
77 todetected regions which occupy the same<br>
78 space on the screen. Defined in the format<br>
79 screen[<idx>]:WIDTHxHEIGHT+X+Y, e.g.<br>
80 screen[1]:800x1200+0+0.<br>
81 screenshot_enabled Enable or disable screenshot capability.<br>
82 screenshot_app Set to the script that will take screen-<br>
83 shots. It will be called with "full" or<br>
84 "window" as parameter 1 to indicate what<br>
85 screenshot action is expected. The script<br>
86 shall handle those cases accordingly.<br>
87 term_width Set a preferred minimum width for the termi-<br>
88 nal If this value is greater than 0, scrotwm<br>
89 will attempt to adjust the font sizes in the<br>
90 terminal to keep the terminal width above<br>
91 this number as the window is resized. Only<br>
92 <font color="#ff40ff">xterm(1)</font> is currently supported. The<br>
93 <font color="#ff40ff">xterm(1)</font> binary must not be setuid or set-<br>
94 gid, which it is by default on most systems.<br>
95 Users may need to set spawn term to use an<br>
96 alternate copy of the <font color="#ff40ff">xterm(1)</font> binary with-<br>
97 out the setgid bit set.<br>
98 modkey Change mod key. Mod1 is generally the ALT<br>
99 key and Mod4 is the windows key on a PC.<br>
100 bind[x] Bind key combo to action x. See the<br>
101 BINDINGS section below.<br>
103 Colors need to be specified per the <font color="#ff40ff">XQueryColor(3)</font> specification and<br>
104 fonts need to be specified per the <font color="#ff40ff">XQueryFont(3)</font> specification.<br>
106 <font color="#ffff00">BINDINGS</font><br>
107 scrotwm provides many functions (or actions) accessed via key or mouse<br>
108 bindings.<br>
110 The current mouse bindings are described below:<br>
112 M1 Focus window<br>
113 M-M1 Move window<br>
114 M-M3 Resize window<br>
115 M-S-M3 Resize window while maintaining it centered<br>
117 The default key bindings are described below:<br>
119 M-S-<Return> spawn_term<br>
120 M-p spawn_menu<br>
121 M-S-q quit<br>
122 M-q restart scrotwm<br>
123 M-<Space> cycle_layout<br>
124 M-S-<Space> reset_layout<br>
125 M-h master_shrink<br>
126 M-l master_grow<br>
127 M-, master_add<br>
128 M-. master_del<br>
129 M-S-, stack_inc<br>
130 M-S-. stack_del<br>
131 M-<Return> swap_main<br>
132 M-j, M-<TAB> focus_next<br>
133 M-k, M-S-<TAB> focus_prev<br>
134 M-m focus_main<br>
135 M-S-j swap_next<br>
136 M-S-k swap_prev<br>
137 M-b bar_toggle<br>
138 M-x wind_del<br>
139 M-S-x wind_kill<br>
140 M-<n> ws_n<br>
141 M-S-<n> mvws_n<br>
142 M-<Right> ws_next<br>
143 M-<Left> ws_prev<br>
144 M-S-<Right> screen_next<br>
145 M-S-<Left> screen_prev<br>
146 M-s screenshot_all<br>
147 M-S-s screenshot_wind<br>
148 M-S-v version<br>
149 M-t float_toggle<br>
150 M-S <Delete> spawn_lock<br>
151 M-S-i spawn_initscr<br>
153 The action names and descriptions are listed below:<br>
155 spawn_term Spawn a new terminal<br>
156 spawn_menu Menu<br>
157 quit Quit scrotwm<br>
158 restart Restart scrotwm<br>
159 cycle_layout Cycle layout<br>
160 reset_layout Reset layout<br>
161 master_shrink Shrink master area<br>
162 master_grow Grow master area<br>
163 master_add Add windows to master area<br>
164 master_del Remove windows from master area<br>
165 stack_inc Add columns/rows to stacking area<br>
166 stack_del Remove columns/rows from stacking area<br>
167 swap_main Move current window to master area<br>
168 focus_next Focus next window in workspace<br>
169 focus_prev Focus previous window in workspace<br>
170 focus_main Focus on main window in workspace<br>
171 swap_next Swap with next window in workspace<br>
172 swap_prev Swap with previous window in workspace<br>
173 bar_toggle Toggle status bar in all workspaces<br>
174 wind_del Delete current window in workspace<br>
175 wind_kill Destroy current window in workspace<br>
176 ws_n Switch to workspace n, where n is 1 through 10<br>
177 mvws_n Move current window to workspace n, where n is 1<br>
178 through 10<br>
179 ws_next Switch to next workspace with a window in it<br>
180 ws_prev Switch to previous workspace with a window in it<br>
181 screen_next Move pointer to next region<br>
182 screen_prev Move pointer to previous region<br>
183 screenshot_all Take screenshot of entire screen (if enabled)<br>
184 screenshot_wind Take screenshot of selected window (if enabled)<br>
185 version Toggle version in status bar<br>
186 float_toggle Toggle focused window between tiled and floating<br>
187 spawn_lock Lock screen<br>
188 spawn_initscr Reinitialize physical screens<br>
190 Custom bindings in the configuration file are specified as follows:<br>
192 bind[<action>] = <keys><br>
194 <action> is one of the actions listed above (or empty) and <keys> is in<br>
195 the form of zero or more modifier keys (MOD, Mod1, Shift, etc.) and one<br>
196 or more normal keys (b, space, etc.), separated by "+". For example:<br>
198 bind[reset] = Mod4+q # bind Windows-key + q to reset<br>
199 bind[] = Mod1+q # unbind Alt + q<br>
201 Multiple key combinations may be bound to the same action.<br>
203 <font color="#ffff00">FILES</font><br>
204 ~/.scrotwm.conf scrotwm user specific settings.<br>
205 /etc/scrotwm.conf scrotwm global settings.<br>
207 <font color="#ffff00">HISTORY</font><br>
208 scrotwm was inspired by xmonad & dwm.<br>
210 <font color="#ffff00">AUTHORS</font><br>
211 scrotwm was written by Marco Peereboom <marco@peereboom.us>, Ryan Thomas<br>
212 McBride <mcbride@countersiege.com> and Darrin Chandler<br>
213 <dwchandler@stilyagin.com>.<br>
215 <font color="#ffff00">BUGS</font><br>
216 Currently the menu, invoked with M-p, depends on dmenu.<br>
218 OpenBSD 4.5 March 10, 2009 4<br>