wmpager is a simple pager docklet for the Window Maker.
wmpager offers the following features:
- convenient workspace switching using the mouse for up to nine workspaces
- automatic configuration according to the number of workspaces (you may
however if you like also specify the number of workspaces and the layour
of wmpager yourself)
- automagic adjustment to the currently active workspace (if you happen to
switch workspaces using the keyboard or some other Window Maker means)
- configurable look and feel to match your Window Maker theme
- tooltips for the workspace names (if you happen to have to many workspaces
and can't remember which is which ;-))
The following screenshots show the wmpager with various themes docked to the
right side of the screen with four workspaces in a 2x2 layout:
wmpager supports themes in form of XPM files. To select another
theme simply start it with the -t or --theme
option and specify the theme name.
The list of themes distributed with wmpager includes:
- blue (the built-in theme)
wmpager looks for theme files in various places:
- in a user-specific directory ~/.wmpager/
- in the installation directory specified with option
-i or --installdir
- in the default installation directory /usr/local/share/wmpager
if the installation directory has not been specified
You may specify a theme using the -t or --theme
either as a simple name (e.g. fire) or as a pathname
pointing to the theme file (e.g. /some/where/fire.xpm).
In any case you may omit the trailing .xpm if you like.
Building your own theme
If you want to create a theme file yourself I suggest you copy
one of the existing ones and modify it to your needs. If you really
want to know, the format of the file is described below.
A sample theme file looks as follows (the images below have been
converted to PNG for easy viewing in the browser, the wmpager
however only supports XPM):
XPM file format: The XPM file has to be at least 102 by 71 pixels in
size. The area 0,0 to 50,50 describes the background for the selected
workspace, the area 51,0 to 101,50 for unselected work spaces. The
area has to include a one-pixel border that is used for all workspace
buttons. From 0,51 to 89,60 are the digits used for the selected
workspace (each 10x10 pixels, 1-9 from left to right) and from 0,61 to
89,70 are the digits for unselected workspaces. The digits may have
a transparent background.