NAME

pwm - an X11 window manager

SYNOPSIS

pwm [options]

DESCRIPTION

PWM is a rather lightweight window manager that can have multiple client windows attached to a single frame. This feature helps keeping windows, especially the numerous xterms, organized.

OPTIONS

-display host:display.screen: X display to manage
-cfgfile configfile: Config file to use instead of default
-onescreen: On X servers with multiple screens, manage only default screen, not all.
-help: Show help on command line options
-version: Show version
-about: Show about text

KEYS

These are the default keybindings. Mod1 depends on your system. On PC:s with XFree86 it is probably bound to the left alt key (Alt_L). On Suns it is usually bound to the diamond keys (Meta_L, Meta_R). Use xmodmap(1x) to find out.

Global keys

Mod1+Tab: Circulate through the list of windows
Mod1+Shift+Tab: Backwards circulate through the list of windows
Mod1+n: Go to workspace n, where n is 1-9 or 0.
Mod1+M: "Root menu"
Mod1+G: "Go to menu". Use this menu to select a window to activate.
Mod1+D: "Detach menu". Use this menu to detach a window from a group on current workspace.
Mod1+T: Toggle dock visibility
Mod1+E: Run an xterm

Frame/window control keys

These are the keys used to manipulate active frame and client window. They mostly use Control+Shift modifier.

Mod1+Enter: Keyboard move/resize mode
Control+Shift+W: Close window
Control+Shift+X: Kill client owning active window
Control+Shift+S: Toggle shading of frame
Control+Shift+Z: Toggle stickiness of frame
Control+Shift+V: (Un)maximize vertically
Control+Shift+H: (Un)maximize horizontally
Control+Shift+M: (Un)maximize both vertically and horizontally
Control+Shift+R: Raise frame
Control+Shift+L: Lower frame
Control+Shift+A: "Attach menu". Use to attach window to the frame.
Control+Shift+O: "Window menu"
Control+Shift+N: Go to next window within frame
Control+Shift+P: Go to previous window within frame
Control+Shift+n: Goto n:th window within frame, where n is 1-9 or 0.

Menus

These keys can be used in menus

Down or N: Next entry
Up or P: Previous entry
Right or Space: Enter submenu
Left or B: Leave submenu
Enter: Execute activated entry
Esc: Close menu
Z: Set the menu in "keep mode"

Move/resize mode

These keys can be used while in move/resize mode.

Escape: Leave mode changes omitted.
Enter: Leave mode applying changes.
Right/Left/Down/Up: Move the frame to specific direction in bigger steps.
Mod1+Right/Left/Down/Up: Shrink/grow the frame in specific direction in bigger steps.
Mod1+Right/Left/Down/Up: Move the frame to specific direction by on pixel.
Mod1+Right/Left/Down/Up: Shrink/grow the frame in specific direction by minimum amount requested by application.

FILES

/usr/local/etc/pwm/pwm.conf: System default configuration file
/usr/local/etc/pwm/look-*.conf: Color scheme configuration files
/usr/local/etc/pwm/keys-*.conf: Key binding configuration files
/usr/local/etc/pwm/buttons-*.conf: Pointer (mouse) button binding configuration files
~/.pwm/pwm.conf: User default configuration file (overrides system default)

AUTHOR

PWM was written by Tuomo Valkonen <tuomov at iki.fi> with ideas and complaints from various people.