1wmpager(1x) wmpager(1x)
2
6 wmpager - Window Maker workspace pager docklet
7
9 wmpager [options]
10
12 wmpager is a Window Maker pager docklet that offers:
13 · workspace switching for up to nine workspaces
14 · automatic configuration according to the number of available
15 workspaces
16 · automagic adjustment to the currently active workspace
17 · configurable look and feel
18
20 -h --help
21 Display usage and version information.
22 -v --verbose
23 Enable verbose message output.
24 -d --display <name>
25 The display to use (defaults to the 'DISPLAY' environment vari‐
26 able).
27 -s --size <w>x<h>
28 The number of buttons to display. The default depends on the
29 number of workspaces you have, i.e. 2x2 for 4 workspaces, 2x3
30 for 6, maximum is 3x3.
31 -w --workspaces <count>
32 The number of workspace buttons to display. The default is the
33 number of workspaces you have up to a maximum is 9.
34 -t --theme <theme.xpm>
35 The button theme to use. <theme.xpm> is either an absolute path‐
36 name pointing to an 'xpm' theme file or a filename relative to
37 the installation directory (see option --installdir). The exten‐
38 sion '.xpm' in the file or pathname is optional.
39 For more information on theme files see the entry BUTTON THEMES
40 below.
41 -i --installdir <dir>
42 Specifies the location of the installation directory. wmpager
43 looks for 'xpm' theme files at this location. The default are
44 '/usr/local/share/wmpager/' and the user specific '~/.wmpager'
45 directory.
46
48 Depending on your WindowMaker theme you might want to use another theme
49 for wmpager as well. Use option '-t' or '--theme' to specify the loca‐
50 tion of an XPM file (the extension '.xpm' is optional, it has to be an
51 XPM file though). If you use option '-i', '--installdir' or have set
52 the environment variable WMPAGER to the installation location of the
53 wmpager themes, then you may also skip the path to the theme.
54 Predefined themes: Well, I'm not much of an artist therefore I've only
56 included some themes to give you an idea of how a real nice theme might
57 be done. Naturally, I use the built-in theme and theme support is only
58 there because I have been asked to include it...
59 If you create a theme yourself please send it to me and I'll include it
61 in the next build.
62 The list of predefined themes in this release includes:
64 · blue (the built-in theme)
65 · fire
66 · gray
67 · steel
68 Creating your own themes: If you want to create your own theme simply
70 take one of the included XPM theme files and modify it to your needs.
71 If you really want to know, the format of the file is described below.
72 XPM file format: The XPM file has to be at least 102 by 71 pixels in
74 size. The area 0,0 to 50,50 describes the background for the selected
75 workspace, the area 51,0 to 101,50 for unselected work spaces. The area
76 has to include a one-pixel border that is used for all workspace but‐
77 tons. From 0,51 to 89,60 are the digits used for the selected workspace
78 (each 10x10 pixels, 1-9 from left to right) and from 0,61 to 89,70 are
79 the digits for unselected workspaces. The digits may have a transparent
80 background.
81
83 In order for wmpager to work properly you need to have your Window
84 Maker compiled with Gnome support. (I don't know if this is the case
85 for the precompiled Window Makers usually found in Linux distributions
86 since I usually build my Window Maker myself.)
87 wmpager uses the Gnome support messages sent out by Window Maker to
89 display the currently active workspace. Without Gnome support the pager
90 will not automatically adjust the currently active desktop.
91
93 To file a bugreport please use the bug tracking system at:
94 http://sourceforge.net/projects/wmpager/
95
97 Bruno Essmann <essmann@users.sourceforge.net>
98 http://wmpager.sourceforge.net/
99
101 Thanks to all at Ergon Informatik AG who are using wmpager and helped
102 improve it!
103 http://www.ergon.ch/
104
106 wmaker(1x)
107wmpager-1.2 2002 Aug 16 wmpager(1x)