PWM(1)

NAME
PWM - An X11 window manager

SYNOPSIS
pwm3 [options]

DESCRIPTION
The original PWM was the first tabbing window manager. This version of PWM is based on the code of Ion and is actually exactly the same window manager with only differences in default configuration files, configuration file lookup paths and some options.

OPTIONS

-display host:display.screen
    X display to manage

-conffile configfile
    Configuration file to use instead of default

-searchdir dir
    Directory to search for configuration files and other scripts

-oneroot
    On X servers with multiple (traditional non-Xinerama) screens, manage only default screen (root window), not all, as given by the -display option or in the DISPLAY environment variable.

-sessionname session_name
    Set session name. This option affects where workspace and other save files are put (~/.pwm3/session_name if option set).

-help
    Show help on command line options

-version
    Show version

-about
    Show about text (version, copyright)

BINDINGS
These are the default key and pointer bindings. (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. The string in square brackets after a binding group heading below indicates the module that whose configuration file defines these bindings.

  Globally available bindings

Mod1+1, Mod1+2, Mod1+3, Mod1+4, Mod1+5, Mod1+6, Mod1+7, Mod1+8, Mod1+9, Mod1+0
    Switch to n:th object (workspace, full screen client window) within current screen.

Mod1+comma, Mod1+period
    Switch to next/previous object within current screen.

Mod1+K K
    Go to first region demanding attention or previously active one.

Mod1+K T
    Clear all tags.

Mod1+Shift+1, Mod1+Shift+2
    Go to n:th screen on multihead setup.

Mod1+Shift+comma, Mod1+Shift+period
    Go to next/previous screen on multihead setup.

Mod1+F9
    Create a new workspace of chosen default type.

F12, Button3 press
    Display the main menu.

Button2 press
    Display the window list menu.

Mod1+Tab
    Forward-circulate focus.

Mod1+K Tab
    Backward-circulate focus.

Mod1+K R
    Raise focused object, if possible.

Mod1+C
    Close current object.

Mod1+K D
    Detach (float) or reattach an object to its previous location.

  Bindings operating on frames and their children

Mod1+K H, Mod1+K V
    Maximize the frame horizontally/vertically.

Button3 press
    Display context menu.

Mod1+R
    Begin move/resize mode.

Button1 click at tab, Button2 click at tab
    Switch the frame to display the object indicated by the tab.

Button1 drag at border, Mod1+Button3 drag
    Resize the frame.

Mod1+Button1 drag
    Move the frame.

Button1 drag at tab, Button2 drag at tab
    Move objects between frames by dragging and dropping the tab.

  Move/resize mode bindings

Escape
    Cancel the resize mode.

Return
    End the resize mode.

Left, Right, Up, Down, F, B, P, N
    Grow in specified direction.

Shift+Left, Shift+Right, Shift+Up, Shift+Down, Shift+F, Shift+B, Shift+P, Shift+N
    Shrink in specified direction.

Mod1+Left, Mod1+Right, Mod1+Up, Mod1+Down, Mod1+F, Mod1+B, Mod1+P, Mod1+N
    Move in specified direction.

  Bindings for floating workspaces and frames [mod_floatws]
?

Button1 double click at tab
    Toggle shade mode

Button1 press at tab, Button1 press at border, Mod1+Button1 click
    Raise the frame.

Mod1+Button3 click
    Lower the frame.

Button1 drag at tab
    Move the frame.

  Bindings for menus [mod_menu]

Escape, Control+G, Control+C, Left
    Close the menu.

Return, KP_Enter, Control+M, Right
    Activate current menu entry.

Control+N, Control+P, Up, Down
    Select next/previous menu entry.

BackSpace
    Clear the menu's typeahead find buffer.

FILES AND DIRECTORIES

/usr/local/share/examples/ion3/cfg_pwm.lua
    System default main configuration file

/usr/local/share/examples/ion3/cfg_*.lua
    Other configuration files

/usr/local/share/examples/ion3/look_*.lua
    Colour scheme configuration files

~/.pwm3/
    User configuration files

~/.pwm3/cfg_pwm.lua
    User default main configuration file (overrides system default)

SEE ALSO
For more information, see ion3(1).

AUTHOR
Both PWM and Ion have been written by Tuomo Valkonen <tuomov at iki.fi>.