pwm1(1) · carta

Usage

pwm [options]

Overview

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

/etc/X11/pwm/pwm.conf: System default configuration file

/etc/X11/pwm/look-*.conf: Color scheme configuration files

/etc/X11/pwm/keys-*.conf: Key binding configuration files

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

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

Releases

Unchanged in 2 releases since Debian 3.1 (Sarge).

3.1–4.0