Content-type: text/html Manpage of jwm

jwm

Section: User Commands (1)
Updated: 2005-09-24
Index
 

NAME

JWM - Joe's Window Manager

 

SYNOPSIS

jwm [options]  

DESCRIPTION

JWM is a window manager for the X11 Window System.

 

OPTIONS

-display display
This option specifies the display to use; see X.
-exit
Exit JWM by sending _JWM_EXIT to the root window.
-h
Display a help message and exit.
-p
Parse the configuration file and exit. It is a good idea to use this after making modifications to the configuration file to ensure there are no errors.
-restart
Restart JWM by sending _JWM_RESTART to the root window.
-v
Display version information and exit.

 

FILES

/usr/local/etc/system.jwmrc
The default JWM configuration file.
~/.jwmrc
Local configuration file. Copy the default configuration file to this location to make user-specific changes.

 

CONFIGURATION

OVERVIEW
Configureation of JWM is done by editing ".jwmrc". This file is XML making it easy to edit, either by hand or programmatically. The example.jwmrc gives an example configuration file which specifies all the options. Before restarting JWM, it is a good idea to run "jwm -p" to make sure the configuration file is free of errors. Otherwise you may end up without a root menu.
ROOT MENU
The root menu in JWM is the primary way of starting programs. It also provides a way to restart or exit the window manager. The outer most tag is RootMenu. An optional attribute, label, allows one to specify the name of this menu as shown in the tray. If this attribute is not given, "JWM" will be used. The icon attribute allows one to specify and icon to appear with the menu name. Within this tag the following tags are supported: Menu
This tag creates a submenu item. Any of the tags allowed within the RootMenu tag, including the Menu tag are allowed within this element. The label arrtibute specifies the name of the submenu. The icon attribute allows one to specify and icon for this submenu.
Program
The Program tag provides a way to start an external program. The text in this tag is the command used to start he program. An optional attribute, label, allows one to specify what to show on the menu. If this attribute is not given the command is shown. The icon attribute allows one to specify an icon for this menu item.
Separator
This tag simply puts a line in the menu allowing menu divisions. No text or attributes are used.
Restart
This tag adds a menu item to restart the window manager. An optional attribute, label, allows one to specify what to show on the menu. If this attribute is not given, "Restart" will be shown. The icon attribute allows one to specify an icon for this menu item.
Exit
This tag adds a menu item to exit the window manager. An optional attribute, label, allows one to specify what to show on the menu. If this attribute is not given, "Exit" will be shown. If text is specified inside this tag it will be interpreted as a command to run when JWM exits. This can be used to start another window manager. The icon attribute allows one to specify an icon for this menu item. Finally, the confirm attribute allows one to specify whether a confirm dialog is displayed after clicking this item. Possible values are true and false The default is true. Note that confirm dialogs can be disabled completely at the compile-time.

INCLUDES

Other configuration files may be included under the JWM tag via the Include tag. The text of this tag specifies the location of an additional configuration file. The path may be relative to the loacation JWM was started, an absolute path, or a path referencing an environment variable (using '$'). The format of the configuration file is the same as the main configuration file.

GROUP SETTINGS

Program groups allow one to specify options which apply to a group of programs by name and/or class. A program group is created with the Group tag. As many program groups can be created as desired. Within the Group tag the following tags are supported: Name
The title of a program to match to be in this group. This field is case sensitive. a wild card, *, may be used.
Class
The window class for a program to match to be in this group. This field is case sensitive. A wild card, *, may be used.
Option
An option for this group. Possible options are given below: border
Causes windows in this group to have a border.
desktop:#
The desktop on which windows in this group will be started.
icon:image.xpm
The icon to be used for windows in this group.
layer:#
The layer on which windows in this group will be started.
noborder
Causes windows in this group to be displayed without a border.
nolist
Causes the tray to ignore windows in this group.
notitle
Causes windows in this group to be displayed without a title bar.
sticky
Make windows in this group sticky.
title
Causes windows in this group to have a title bar.

BORDER SETTINGS

The Border tag controls the look of window borders. Within this tag, the following tags are supported: Font
The font used for title bars. See Fonts section for more information
Width
The width of window borders in pixels. The default is 5, the minimum is 3, and the maximum is 32.
Height
The height of window title bars in pixels. The default is 21, the minimum is 2, and the maximum is 64.
Foreground
The color of text on inactive title bars. See the COLORS section for more information.
Background
The border background color for inactive borders. See the COLORS section for more information.
ActiveForeground
The color of text on active title bars. See the COLORS section for more information.
ActiveBackground
The border background color for active borders. See the COLORS section for more information.

TRAY SETTINGS

The Tray tag controls the look of the tray. An optional attribute, autohide, may be specified to turn on or off automatic hidding of the tray. Possible values for the autohide attribute are true and false. By default, automatic hidding is disabled. An optional attribute, maxwidth, may be specified to set the maximum width of a program in the tray in pixels. The default is 0 (zero), which specifies no limit. An optional attribute, layer, may be specified to determine the layer of the tray. Valid values are integers between 0 (the lowest layer) and 12 (the top-most layer) inclusive. The default is 8. Finally, an optional attribute, insert, may be specified to indicate how programs are added to the tray. Possible values are right and left. The default is left. Within the Tray tag, the following tags are supported: Font
The font used on the tray. See the FONTS section for more information.
Height
The height of the tray in pixels. The default is 28, the minimum is 8, and the maximum is 128.
Width
The width of the tray in pixels. The default is 0 (zero) indicating full screen width, the minimum is 320.
Alignment
The horizontal alignment of the tay. Possible values are left, center, and right. The default value is center.
Foreground
The text color of inactive items on the tray. See the COLORS section for more information.
Background
The background color of inactive items on the tray. See the COLORS section for more information.
ActiveForeground
The text color of active items on the tray. See the COLORS section for more information.
ActiveBackground
The bacground color of active items on the tray. See the COLORS section for more information.

PAGER SETTINGS

The Pager tag controls the look of the pager on the tray. Within this tag the following tags are supported: Outline
The color of the outline around windows shown in the pager. See the COLORS section for more information.
Foreground
The color of inactive windows shown in the pager. See the COLORS section for more information.
Background
The background color of inactive desktops shown in the pager. See the COLORS section for more information.
ActiveForeground
The color of active windows shown in the pager. See the COLORS section for more information.
ActiveBackground
The color of active desktops shown in the pager. See the COLORS section for more information.

LOAD SETTINGS

The Load tag controls the look of the load status graph on the tray (note that this is an optional feature at compile time and is only supported on some platforms). An optional attribute, enabled, determines if the load display is shown. Possible values are true and false. By default the load graph is enabled. Within this tag, the following tags are supported: Outline
The color of scale lines. See the COLORS section for more information.
Foreground
The foreground color of the load graph. See the COLORS section for more information.
Background
The background color of the load graph. See the COLORS section for more information.

CLOCK SETTINGS

The Clock tag controls the look of the clock on the tray. An optional attribute, enabled, specifies whether or not the clock is displayed. Possible values are true and false. It is enabled by default. Another optional attribute, format, specifies the format of the clock (See "man strftime" for formatting options). Within this tag, the following tag is supported: Program
The program to launch when the clock is clicked.

MENU SETTINGS

The Menu tag controls the look of the menus in JWM (this includes the root menu and window menus). Within this tag, the following tags are supported: Font
The font used on menus See the FONTS section for more information.
Foreground
The text color of inactive menu items. See the COLORS section for more information.
Background
The background color of inactive menu items. See the COLORSsection for more information.
ActiveForeground
The text color of active menu items. See the COLORS section for more information.
ActiveBackground
Text background color of active menu items. See the COLORS section for more information.

FONTS

Fonts for various parts of JWM are specified within a Font tag. The text of this tag determines the font to use. This is a standard X font string. To easily generate such a string, use the "xfontsel" program. An optional attribute, antialias, may be specified to turn on or off antialiasing for this font. By default, antialiasing is enabled. Valid values for the antialias attribute are true and false.

COLORS

Colors for various parts of JWM are specified within specific tags (discribed above). Colors may either be hex triplets in RGB format (for example, #FF0000 is red) or by a name recognized by the X server.

ICONS

Icons for windows that don't supply an icon via the _NET_WM_ICON hint are located by searching the icon search path(s) for an icon whose name (minus the ".xpm" extension) matches the instance name of the window as returned in the WM_CLASS hint. If this lookup fails, a default icon is supplied. This icon will be displayed for the window on it's title bar and on the task bar. Icons that are not an appropriate size as determined by taking the minimum of the title bar height and the tray height will be scaled. Square icons work best. For menu items, the icon path is searched for a match. the icon specified for a menu item must be the exact name of the icon file with the extension. If no match is found, a blank area will appear where the icon should appear. If an icon is not specified for any menu item in a menu, no space will be allocated for icons. Icon properties are contained within the Icons tag. Within this tag, zero or more IconPath tags may be specified. The text of this tag is assumed to be an absolute directory path to a directory containing XPM icons. When searching for icons, if multiple paths are provided, they will be searched in order until a match is made.

KEY BINDINGS

Keyboard bindings in JWM are specified in Key tags. The required attribute, key, specifies which key will cause an action. The optional attribute, mask, specifies what key mask, if any, must be in effect for the binding to match. Finally, the text of the Key tag is the action to perform. One or more of the following key masks may be specified for mask:
A
The "Alt" key.
C
Control
S
Shift
H
Hyper
M
Meta
P
Super
The key specified in the key attribute must contain a valid key string for XStringToKeysym. These values are usually what one would expect (for example, the escape key is called "Escape"). Valid actions for a key binding are:
up
Move up. Not grabbed.
down
Move down. Not grabbed.
right
Move right. Not grabbed.
left
Move left. Not grabbed.
escape
Stop a move/resize or exit a menu. Not grabbed.
select
Make a menu selection. Not grabbed.
next
Move to the next window. Grabbed.
close
Close the active window. Grabbed.
minimize
Minimize the active window. Grabbed.
maximize
Maximize the active window. Grabbed.
shade
Shade the active window. Grabbed.
move
Move the active window. Grabbed.
resize
Resize the active window. Grabbed.
root
Show the root menu. Grabbed.
window
Show the window menu for the active window. Grabbed.
desktop
Switch to the next desktop. Grabbed.
desktop#
Switch to a specific desktop. To use this, "#" must be specified in the key section. The number 1 to the number of desktops configured are then substituted for "#". Grabbed.
exec:command
Execute command. Grabbed.
restart
Restart JWM. Grabbed.
Note that keys that are grabbed will not be available to applications other than JWM since JWM will interpret these. Also note that there are no default key bindings. Finally, it is possible to bind multiple key combinations to the same action.

MOUSE BINDINGS

Note that in the future this may be configurable.
Any button on the root window will bring up the root menu.
The right button will show the window menu on the frame.
The left button will resize if on the border or move if in the title bar.
The middle button will move anywhere on the frame.
A double click on the title bar of a window will toggle shading. The mouse wheel will move through menus when a menu is open, show the root menu when over root, or switch desktops when over the pager.

OTHER SETTINGS

The following tags may also be supplied: DesktopCount
The number of desktops. The default is 4. Valid values are between 1 and 8 inclusive.
DoubleClickDelta
The number of pixels the mouse can move during a double click. The default is 2. Valid values are between 0 and 32 inclusive.
DoubleClickSpeed
The maximum number of milliseconds between clicks for a double click. The default is 400. Valid values are between 1 and 2000 inclusive.
FocusModel
The focus model to be used. The default is "sloppy". Valid values are "click" (click to focus) and "sloppy" (focus follows mouse).
MoveMode
The move mode. The default is "opaque". Valid values are "opaque" and "outline".
ResizeMode
The resize mode. The default is "opaque". Valid values are "opaque" and "outline".
SnapMode
The snap mode. The default is "border". Valid values are "none", "screen", and "border". An optional attribute, distance, specifies the distance for snapping. The default is 5. Valid values are between 1 and 32 inclusive.

 

BUGS

Please report all bugs for this hacked version of jwm to Terry Loveall <loveall at iinet.com>.

 

AUTHOR

Joe Wingbermuehle <joewing@joewing.net>

 

HACK MAINTAINER

Terry Loveall <loveall at iinet.com>

 


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FILES
CONFIGURATION
BUGS
AUTHOR
MAINTAINER
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 01:24:30 GMT, October 02, 2005