Photon Window Manager
pwm [-CcdfGKknPrSW] [-a C|L|R] [-b color]
[-g input_group] [-R [b|c|f|m|r|t]...]
[-s server] [-Xcurs[,clr]]
- -a C|L|R
- Alignment. By default, title alignment is centered (C)
in the title bar. This option lets you change the alignment to either
left (L) or right (R) justification.
- -b color
- Background color (hex RGB value).
- Shut down the window manager when you close the last window
(bkgdmgr and shelf are considered windows).
- Cursor focus. By default, focus is given to a window when you click
anywhere inside it. This option lets you change keyboard
focus so that it follows the cursor. You can toggle this
behavior within pwm using the Cursor Focus option.
- Full window dragging. Change the default dragging from outline to
full window dragging. You can toggle this behavior within
pwm using the Full Window Dragging option.
- Click to front. By default, a window is brought to the front only if
you click on the window title bar. This option lets you
click anywhere in a window to bring it to the front. You can
also set this behavior within pwm using the Click to Front option.
- Enable multi-monitor placement policy.
- -g input_group
- Set the PWM input group (default 1).
- Disable the keyboard.
- Always process Ctrl-Alt keychords. This
option allows Ctrl-Alt to
always be recognized by PWM for keyboard navigation. By default, each
window has its own Ctrl-Alt state.
- Disable Cursor focus.
If the cursor focus is set to the default mode in a mouse-less
environment (or when the mouse doesn't start) a window can't be accessed. This option
provides a override for a mouse-less environment.
The ph -s command
calls pwm with this option.
- Disable console switching, the workspace menu, and the keyboard.
This option is an alternative to specifying -KSW.
- -R [b|c|f|m|r|t]
- Run PWM on a remote computer (phditto/phindows).
- b -- Remove borders from application window.
- c -- Close PWM when there are no child windows to manage.
- f -- Fit (make application always fit remote window).
- m -- Maximize (initially resize application to fit remote window).
- r -- Resize remote (initially resize remote window to fit application).
- t -- Pass application window title to remote window.
- Auto-raise window on steady cursor.
- Disable console switching.
- -s server_name
- The name of the Photon server. The default is /dev/photon.
- Disable the workspace menu.
- Define default cursor type (E9xx code) and color (hex RGB value)
The Photon Window Manager (pwm) provides standard
window management functions, including move, resize,
minimize, maximize, raise, lower, and close. It provides
common window frame borders that applications can customize, depending on
Apart from the -f click-to-front option listed above, pwm
also enables the following key combinations:
- Alt-Shift-Esc -- back-most window to front
- Alt-Esc -- front-most window to back
- Ctrl-Alt-1-9 -- switch to console number 1 to 9
- Ctrl-Alt-Return, Enter, or + -- Cycle to the next console with an active window.
- Ctrl-Alt-Backspace or - -- Cycle to the previous console with an active window.
- Alt-F2 -- Bring the next window in the console to the front.
- Alt-F3 -- Bring the previous window in the console to the front.
- Alt-F4 -- Close the current application.
- Alt-F5 -- Restore the current window, if it is maximized.
- Alt-F7 -- Move the window. Use the arrow keys or mouse to move the window.
- Alt-F8 -- Resize the window. Use the arrow keys or the mouse to resize the window.
- Alt-F9 -- Minimize the current window.
- Alt-F10 -- Maximize the current window.
- Print Screen -- Start snapshot to take a screen shot.
Selecting Desktop Config... from the Desktop Menu launches the
program, which lets you configure the workspace.
Each user can configure the Desktop menu.
The configuration file is in
||If you create your own menu, you won't see new menu items when they're added
to the default one.|
Here's a sample personal PWM menu:
= Desktop Menu
Terminal T pterm
Graphics Config... G phgrafx
Desktop Config... W pwmopts
Shelf Config... S shelf -c
Mail M pterm elm
News N pterm trn
Shutdown... u phshutdown
The format of the file is simple; each line describes a menu item. Menu items are
defined in the form:
If the line starts with:
- an equals sign, the rest of the line is the menu title
- a hyphen, it's a menu separator.
You can't use environment variables because the command parsing
is simple. However, you can write the command to a shell script and specify
the script as the command to run.
Start the window manager with left-side title alignment, cursor focus, and
pwm -cf -aL
- Holds a user's PWM workspace configuration.
- Holds a user's custom PWM Workspace menu.
- When set, disables the confirmation dialog when Photon exits.
To disable this dialog, add the following lines before
the ph command in your
# disable confirmation dialog when Photon exits
- Specifies the options to be passed automatically to pwm.
Using the Photon microGUI
in the Neutrino User's Guide