mirror of
https://github.com/vale981/spectrwm
synced 2025-03-06 02:01:42 -05:00
154 lines
20 KiB
HTML
154 lines
20 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
<html>
|
|
<head>
|
|
<title>~/scrotwm.~.html</title>
|
|
<meta name="Generator" content="Vim/7.2">
|
|
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
|
|
</head>
|
|
<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 - window manager for X11<br>
|
|
<br>
|
|
<font color="#ffff00">SYNOPSIS</font><br>
|
|
scrotwm<br>
|
|
<br>
|
|
<font color="#ffff00">DESCRIPTION</font><br>
|
|
scrotwm is a minimalistic window manager that tries to stay out of the<br>
|
|
way so that valuable screen real estate can be used for much more impor-<br>
|
|
tant stuff. It has sane defaults and does not require one to learn a<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>
|
|
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-S-, Add columns/rows to stacking area<br>
|
|
M-S-. Remove columns/rows from stacking 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-x Delete current window in workspace<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>
|
|
M-S <Delete> Lock scren<br>
|
|
M-S-i Reinitialize physical screens<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>
|
|
The file supports the following keywords:<br>
|
|
<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>
|
|
region Allocates a custom region, removing any au-<br>
|
|
todetected regions which occupy the same<br>
|
|
space on the screen. Defined in the format<br>
|
|
screen[<idx>]:WIDTHxHEIGHT+X+Y, e.g.<br>
|
|
screen[1]:800x1200+0+0.<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>
|
|
term_width Set a preferred minimum width for the termi-<br>
|
|
nal If this value is greater than 0, scrotwm<br>
|
|
will attempt to adjust the font sizes in the<br>
|
|
terminal to keep the terminal width above<br>
|
|
this number as the window is resized. Only<br>
|
|
<font color="#ff40ff">xterm(1)</font> is currently supported. The<br>
|
|
<font color="#ff40ff">xterm(1)</font> binary must not be setuid or set-<br>
|
|
gid, which it is by default on most systems.<br>
|
|
Users may need to set spawn term to use an<br>
|
|
alternate copy of the <font color="#ff40ff">xterm(1)</font> binary with-<br>
|
|
out the setgid bit set.<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>
|
|
<font color="#ffff00">FILES</font><br>
|
|
~/.scrotwm.conf scrotwm user specific settings.<br>
|
|
/etc/scrotwm.conf scrotwm global settings.<br>
|
|
<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">BUGS</font><br>
|
|
Currently the menu, invoked with M-p, depends on dmenu.<br>
|
|
<br>
|
|
OpenBSD 4.4 February 10, 2009 3<br>
|
|
</font></body>
|
|
</html>
|
|
<br>
|
|
<small>
|
|
$scrotwm$
|