1wmsystemtray(1) General Commands Manual wmsystemtray(1)
2
6 wmsystemtray - A freedesktop.org system tray as a Window Maker dock app
7
9 wmsystemtray [options]
10
12 wmsystemtray is a system tray using the freedesktop.org system tray
13 protocol designed as a Window Maker dock app. It has the ability to
14 display more than one dock window to make room for more tray icons, and
15 the ability to scroll through the icons if more are present than will
16 fit.
17
19 -display <display name>
20 Name of display to use.
21 --help Display usage information.
23 -V, --version
25 Display the version number and exit.
26 -v, --verbose
28 Print more messages to the console. May be repeated.
29 -q, --quiet
31 Print fewer messages to the console. May be repeated.
32 -s, --small
34 Use 16x16 tray icons, instead of 24x24. In other words, fit 9
35 icons instead of 4 in one dock window.
36 -w <n>, --windows <n>
38 Specifies the number of dock windows to open. Each dock window
39 is assigned a unique name (i.e. the first is wmsystemtray.wmsys‐
40 temtray0, the second wmsystemtray.wmsystemtray1, and so on), so
41 they can be reliably positioned in the dock or clip.
42 --id-windows
44 Print the window's index number on the window, to make it easier
45 to dock them in the right order. Note that if there are enough
46 tray icons active, this number may be covered up.
47 --fill-rows
49 Normally the first dock window is completely filled before any
50 tray icons are placed in the second. This option fills the top
51 row of each dock window before placing any icons in the second
52 row, which may make more sense if you arrange the dock windows
53 horizontally.
54 --arrows <place>
56 Normally, every dock window has both left and right scrolling
57 arrows at the bottom. Specifying --arrows horizontal places the
58 left arrow only on the first window and the right arrow only on
59 the last, which may make more sense if the windows are arranged
60 horizontally. --arrows vertical places the arrows only on the
61 last window, which may make more sense if the windows are ar‐
62 ranged vertically.
63 -c <color>, --fgcolor <color>
65 Specify a color for the page indicator and --id-windows indica‐
66 tors, instead of black. Colors may be specified in any format
67 recognized by XParseColor In short, that's any color name in X's
68 rgb.txt or an RGB color specified as "rgb:rr/gg/gg".
69 --bgcolor <color>
71 In non-Window Maker mode, specify the color for the window back‐
72 ground. The default is to shape the window to fit the used area
73 and to set ParentRelative, which attempts to copy whatever is
74 behind the window.
75 --non-wmaker
77 Activate non-Window Maker mode. This provides limited support
78 for using the program in window managers that don't do Window
79 Maker-style dockapps; the application still sizes itself as a
80 64x64 window, however, so you might be better served by a more
81 traditional system tray.
82
84 The main portion of the dockapp has room for four 24x24 or nine 16x16
85 tray icons. At the bottom are left and right arrows for paging when
86 more tray icons are available than can be displayed at once, with an
87 indicator between showing the current "page" of icons and total number
88 of pages currently available.
89 In addition to left-clicking either scrolling arrows, the mouse's
91 scroll wheel may be used on the bottom section to change pages.
92
94 SIGUSR1 and SIGUSR2 may be used to change pages. A program such as
95 xbindkeys may be used to send these signals to wmsystemtray on appro‐
96 priate key presses.
97
99 The balloon message portion of the freedesktop.org protocol is not im‐
100 plemented at this time. I've heard that the official Gnome system tray
101 doesn't implement this either, and most tray apps seem to directly use
102 dbus desktop notifications service.
103 Most of the Xembed specification is not implemented, as it is not
105 needed here. For example, the only point to redirecting input focus is
106 to allow the outer window to see input events (and then the outer win‐
107 dow has to forward those events to the embeds). But since we don't re‐
108 ally care, we can just let the icons get events directly. Similarly, we
109 don't take focus or activation, and we don't do accellerators.
110
112 freedesktop.org System Tray Protocol Specification
113 ⟨http://standards.freedesktop.org/systemtray-spec/systemtray-
114 spec-0.3.html⟩
115 freedesktop.org XEmbed Protocol Specification
117 ⟨http://standards.freedesktop.org/xembed-spec/xembed-spec-0.5.html⟩
118
120 wmsystemtray was written by Brad Jorsch <anomie@users.sourceforge.net>.
121 Email regarding wmsystemtray should be sent to anomie@users.source‐
123 forge.net.
124
126 When I finally decided to make use of some applications that work via
127 system tray icons, I looked around for a tray for my preferred window
128 manager. Some didn't integrate well (I didn't want a bar at the top or
129 bottom of the screen), some dockapps couldn't handle more than 4 icons
130 at all, some could do 4 icons with paging (and much crashing if any
131 program was killed), some could do more than 4 icons by creating arbi‐
132 trary numbers of app icons (but undockable, because they were created
133 "as needed"). So I decided to write my own, combining the best features
134 into a stable app.
135 July 23, 2022 wmsystemtray(1)