wmpager.1x - Man Page

Window Maker workspace pager docklet


wmpager [options]


wmpager is a Window Maker pager docklet that offers:


-h --help

Display usage and version information.

-v --verbose

Enable verbose message output.

-d --display <name>

The display to use (defaults to the 'DISPLAY' environment variable).

-s --size <w>x<h>

The number of buttons to display. The default depends on the number of  workspaces you have, i.e. 2x2 for 4 workspaces, 2x3 for 6, maximum is 3x3.

-w --workspaces <count>

The number of workspace buttons to display. The default is the number of  workspaces you have up to a maximum is 9.

-t --theme <theme.xpm>

The button theme to use. <theme.xpm> is either an absolute pathname pointing to an 'xpm' theme file or a filename relative to the installation directory (see option --installdir). The extension '.xpm' in the file or pathname is optional.

For more information on theme files see the entry Button Themes below.

-i --installdir <dir>

Specifies the location of the installation directory. wmpager looks for 'xpm' theme files at this location. The default are '/usr/local/share/wmpager/' and the user specific '~/.wmpager' directory.

Button Themes

Depending on your WindowMaker theme you might want to use another theme for wmpager as well. Use option '-t' or '--theme' to specify the location of an XPM file (the extension '.xpm' is optional, it has to be an XPM file though). If you use option '-i', '--installdir' or have set the environment variable WMPAGER to the installation location of the wmpager themes, then you may also skip the path to the theme.

Predefined themes: Well, I'm not much of an artist therefore I've only included some themes to give you an idea of how a real nice theme  might be done. Naturally, I use the built-in theme and theme support is only there because I have been asked to include it...

If you create a theme yourself please send it to me and I'll include it in the next build.

The list of predefined themes in this release includes:


In order for wmpager to work properly you need to have your Window Maker compiled with Gnome support. (I don't know if this is the case for the precompiled Window Makers usually found in Linux distributions since I usually build my Window Maker myself.)

wmpager uses the Gnome support messages sent out by Window Maker to display the currently active workspace. Without Gnome support the pager will not automatically adjust the currently active desktop.


To file a bugreport please use the bug tracking system at:



Bruno Essmann <essmann@users.sourceforge.net>



Thanks to all at Ergon Informatik AG who are using wmpager and helped  improve it!


See Also



2002 Aug 16 wmpager-1.2