SCROTWM(1) OpenBSD Reference Manual SCROTWM(1)
NAME
scrotwm - small dynamic tiling window manager for X11.
SYNOPSIS
scrotwm
DESCRIPTION
scrotwm is a minimalistic window manager that tries to stay out of the
way so that valuable screen real estate can be used for much more impor-
tant stuff. It has sane defaults and does not require one to learn a
language to do any configuration. It was written by hackers for hackers
and it strives to be small, compact and fast.
The following notation is used throughout this page:
M Meta
S Shift
[Name] Named key
M1 Mouse button 1
scrotwm is very simple in its use. Most of the actions are initiated via
keybindings. The current keybindings are described below:
M-S-[Return] Spawn a new terminal.
M-p Menu.
M-S-q Quit.
M-q Restart scrotwm.
M-[Space] Cycle layout.
M-S-[Space] Reset layout.
M-h Shrink master area.
M-l Grow master area.
M-, Add windows to master area.
M-. Remove windows from master area.
M-[Return] Move current window to master area.
M-j Focus next window in workspace.
M-[Tab] Focus next window in workspace.
M-k Focus previous window in workspace.
M-S-[Tab] Focus previous window in workspace.
M-m Focus on main window in workspace.
M-S-j Swap with next window in workspace.
M-S-k Swap with previous window in workspace.
M-b Toggle status bar in all workspaces.
M-S-x Destroy current window in workspace.
M-[Number] Switch to workspace [Number].
M-S-[Number] Move current window to workspace [Number].
M-[RighArrow] Switch to next workspace with a window in it.
M-[LeftArrow] Switch to previous workspace with a window in it.
M-s Take screenshot of entire screen (if enabled).
M-S-s Take screenshot of selected window (if enabled).
M1 Focus window.
FILES
~/.scrotwm.conf
This file contains user specific settings.
/etc/scrotwm.conf
This file contains global settings.
scrotwm first tries to open the user specific file. If that file is un-
available it tries to open the global file next.
The format of the file is <keyword> = <setting>. E.g. color_focus = red.
The file supports the following keywords:
color_focus Border color of the currently focussed window.
color_unfocus Border color of unfocussed windows.
bar_enabled Enable or disable status bar.
bar_border[x] Color of the status bar border in screen x.
bar_color[x] Color of the status bar window in screen x.
bar_font_color[x]
Color of the font in status bar in screen x.
bar_font Status bar font.
bar_action External script to populate additional information
in the status bar such as battery life etc.
bar_delay Update frequency of external script on the status
bar.
spawn_term External application that gets spawned when M-S-[Re-
turn] is used.
dialog_ratio Some applications have dialog windows that are too
small to be useful. This ratio is the screen size
as to what they will be resized. E.g 0.6 is 60% of
the physical screen size.
screenshot_enabled
Set to 1 to enable screen-shotting capability.
Colors need to be specified per the XQueryColor(4) specification and
fonts need to be specified per the XQueryFont(4) specification.
BUGS
Currently the menu, invoked with M-p, depends on dmenu.
AUTHORS
scrotwm was written by Marco Peereboom <marco@peereboom.us> and Ryan
Thomas McBride <mcbride@countersiege.com>.
HISTORY
scrotwm was inspired by xmonad & dwm.
scrotwm first appeared in OpenBSD 4.5.
OpenBSD 4.4 January 25, 2009 2