PWM(1)

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/pkg/etc/pwm/pwm.conf
    System default configuration file

/usr/pkg/etc/pwm/look-*.conf
    Color scheme configuration files

/usr/pkg/etc/pwm/keys-*.conf
    Key binding configuration files

/usr/pkg/etc/pwm/buttons-*.conf
    Pointer (mouse) button binding configuration files

~/.pwm/pwm.conf
    User default configuration file (overrides system default)

SEE ALSO
The PWM home page, http://iki.fi/tuomov/pwm/

/usr/pkg/share/doc/pwm/config.txt

X(1x)

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