<meta name="Generator" content="Vim/7.2">
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
</head>
-<body bgcolor="#ffffff" text="#000000"><font face="monospace">
+<body text="#ffffff" bgcolor="#000000"><font face="monospace">
<font color="#ff40ff">SCROTWM(1) OpenBSD Reference Manual SCROTWM(1)</font><br>
<br>
<font color="#ffff00">NAME</font><br>
- scrotwm - small dynamic tiling window manager for X11.<br>
+ scrotwm - window manager for X11<br>
<br>
<font color="#ffff00">SYNOPSIS</font><br>
scrotwm<br>
language to do any configuration. It was written by hackers for hackers<br>
and it strives to be small, compact and fast.<br>
<br>
+ When scrotwm starts up, it reads settings from its configuration file,<br>
+ scrotwm.conf. See the CONFIGURATION FILES section below.<br>
+<br>
The following notation is used throughout this page:<br>
<br>
M Meta<br>
S Shift<br>
- [Name] Named key<br>
+ <Name> Named key<br>
M1 Mouse button 1<br>
+ M3 Mouse button 3<br>
<br>
scrotwm is very simple in its use. Most of the actions are initiated via<br>
keybindings. The current keybindings are described below:<br>
<br>
- M-S-[Return] Spawn a new terminal.<br>
- M-p Menu.<br>
- M-S-q Quit.<br>
- M-q Restart scrotwm.<br>
- M-[Space] Cycle layout.<br>
- M-S-[Space] Reset layout.<br>
- M-h Shrink master area.<br>
- M-l Grow master area.<br>
- M-, Add windows to master area.<br>
- M-. Remove windows from master area.<br>
- M-[Return] Move current window to master area.<br>
- M-j Focus next window in workspace.<br>
- M-[Tab] Focus next window in workspace.<br>
- M-k Focus previous window in workspace.<br>
- M-S-[Tab] Focus previous window in workspace.<br>
- M-m Focus on main window in workspace.<br>
- M-S-j Swap with next window in workspace.<br>
- M-S-k Swap with previous window in workspace.<br>
- M-b Toggle status bar in all workspaces.<br>
- M-S-x Destroy current window in workspace.<br>
- M-[Number] Switch to workspace [Number].<br>
- M-S-[Number] Move current window to workspace [Number].<br>
- M-[RighArrow] Switch to next workspace with a window in it.<br>
- M-[LeftArrow] Switch to previous workspace with a window in it.<br>
- M-s Take screenshot of entire screen (if enabled).<br>
- M-S-s Take screenshot of selected window (if enabled).<br>
- M1 Focus window.<br>
-<br>
-<font color="#ffff00">FILES</font><br>
- ~/.scrotwm.conf<br>
- This file contains user specific settings.<br>
-<br>
- /etc/scrotwm.conf<br>
- This file contains global settings.<br>
+ M-S-<Return> Spawn a new terminal<br>
+ M-p Menu<br>
+ M-S-q Quit<br>
+ M-q Restart scrotwm<br>
+ M-<Space> Cycle layout<br>
+ M-S-<Space> Reset layout<br>
+ M-h Shrink master area<br>
+ M-l Grow master area<br>
+ M-, Add windows to master area<br>
+ M-. Remove windows from master area<br>
+ M-<Return> Move current window to master area<br>
+ M-j, M-<TAB> Focus next window in workspace<br>
+ M-k, M-S-<TAB> Focus previous window in workspace<br>
+ M-m Focus on main window in workspace<br>
+ M-S-j Swap with next window in workspace<br>
+ M-S-k Swap with previous window in workspace<br>
+ M-b Toggle status bar in all workspaces<br>
+ M-S-x Destroy current window in workspace<br>
+ M-<n> Switch to workspace n<br>
+ M-S-<n> Move current window to workspace n<br>
+ M-<Right> Switch to next workspace with a window in it<br>
+ M-<Left> Switch to previous workspace with a window in it<br>
+ M-S-<Right> Move pointer to next region<br>
+ M-S-<Left> Move pointer to previous region<br>
+ M-s Take screenshot of entire screen (if enabled)<br>
+ M-S-s Take screenshot of selected window (if enabled)<br>
+ M-S-v Toggle version in status bar<br>
+ M-t Toggle focused window between tiled and floating<br>
+ M1 Focus window<br>
+ M-M1 Move window<br>
+ M-M3 Resize window<br>
+ M-S-M3 Resize window while maintaining it centered<br>
+<br>
+<font color="#ffff00">CONFIGURATION FILES</font><br>
+ scrotwm first tries to open the user specific file, ~/.scrotwm.conf. If<br>
+ that file is unavailable, it then tries to open the global configuration<br>
+ file /etc/scrotwm.conf.<br>
+<br>
+ The format of the file is <keyword> = <setting>. For example:<br>
+<br>
+ color_focus = red<br>
+<br>
+ Enabling or disabling an option is done by using 1 or 0 respectively.<br>
<br>
- scrotwm first tries to open the user specific file. If that file is un-<br>
- available it tries to open the global file next.<br>
+ The file supports the following keywords:<br>
<br>
- The format of the file is <keyword> = <setting>. E.g. color_focus = red.<br>
+ color_focus Border color of the currently focussed win-<br>
+ dow.<br>
+ color_unfocus Border color of unfocussed windows.<br>
+ bar_enabled Enable or disable status bar.<br>
+ bar_border[x] Color of the status bar border in screen x.<br>
+ bar_color[x] Color of the status bar window in screen x.<br>
+ bar_font_color[x] Color of the font in status bar in screen x.<br>
+ bar_font Status bar font.<br>
+ bar_action External script that populates additional<br>
+ information in the status bar, such as bat-<br>
+ tery life.<br>
+ bar_delay Update frequency, in seconds, of external<br>
+ script that populates the status bar.<br>
+ spawn_term External application that gets spawned when<br>
+ M-S-<Return> is used.<br>
+ dialog_ratio Some applications have dialogue windows that<br>
+ are too small to be useful. This ratio is<br>
+ the screen size to what they will be re-<br>
+ sized. For example, 0.6 is 60% of the phys-<br>
+ ical screen size.<br>
+ screenshot_enabled Enable or disable screenshot capability.<br>
+ screenshot_app Set to the script that will take screen-<br>
+ shots. It will be called with "full" or<br>
+ "window" as parameter 1 to indicate what<br>
+ screenshot action is expected. The script<br>
+ shall handle those cases accordingly.<br>
+<br>
+ Colors need to be specified per the <font color="#ff40ff">XQueryColor(3)</font> specification and<br>
+ fonts need to be specified per the <font color="#ff40ff">XQueryFont(3)</font> specification.<br>
<br>
- The file supports the following keywords:<br>
- color_focus Border color of the currently focussed window.<br>
- color_unfocus Border color of unfocussed windows.<br>
- bar_enabled Enable or disable status bar.<br>
- bar_border[x] Color of the status bar border in screen x.<br>
- bar_color[x] Color of the status bar window in screen x.<br>
- bar_font_color[x]<br>
- Color of the font in status bar in screen x.<br>
- bar_font Status bar font.<br>
- bar_action External script to populate additional information<br>
- in the status bar such as battery life etc.<br>
- bar_delay Update frequency of external script on the status<br>
- bar.<br>
- spawn_term External application that gets spawned when M-S-[Re-<br>
- turn] is used.<br>
- dialog_ratio Some applications have dialog windows that are too<br>
- small to be useful. This ratio is the screen size<br>
- as to what they will be resized. E.g 0.6 is 60% of<br>
- the physical screen size.<br>
- screenshot_enabled<br>
- Set to 1 to enable screen-shotting capability.<br>
-<br>
- Colors need to be specified per the <font color="#ff40ff">XQueryColor(4)</font> specification and<br>
- fonts need to be specified per the <font color="#ff40ff">XQueryFont(4)</font> specification.<br>
+<font color="#ffff00">FILES</font><br>
+ ~/.scrotwm.conf scrotwm user specific settings.<br>
+ /etc/scrotwm.conf scrotwm global settings.<br>
<br>
-<font color="#ffff00">BUGS</font><br>
- Currently the menu, invoked with M-p, depends on dmenu.<br>
+<font color="#ffff00">HISTORY</font><br>
+ scrotwm was inspired by xmonad & dwm.<br>
<br>
<font color="#ffff00">AUTHORS</font><br>
scrotwm was written by Marco Peereboom <marco@peereboom.us> and Ryan<br>
Thomas McBride <mcbride@countersiege.com>.<br>
<br>
-<font color="#ffff00">HISTORY</font><br>
- scrotwm was inspired by xmonad & dwm.<br>
-<br>
- scrotwm first appeared in OpenBSD 4.5.<br>
+<font color="#ffff00">BUGS</font><br>
+ Currently the menu, invoked with M-p, depends on dmenu.<br>
<br>
-OpenBSD 4.4 January 25, 2009 2<br>
+OpenBSD 4.4 February 1, 2009 2<br>
</font></body>
</html>
<br>