1wmsystemtray(1)             General Commands Manual            wmsystemtray(1)
2
3
4

NAME

6       wmsystemtray - A freedesktop.org system tray as a Window Maker dock app
7

SYNOPSIS

9       wmsystemtray [options]
10

DESCRIPTION

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

OPTIONS

19       -display <display name>
20              Name of display to use.
21
22       --help Display usage information.
23
24       -V, --version
25              Display the version number and exit.
26
27       -v, --verbose
28              Print more messages to the console. May be repeated.
29
30       -q, --quiet
31              Print fewer messages to the console. May be repeated.
32
33       -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
37       -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
43       --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
48       --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
55       --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
64       -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
70       --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
76       --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

DISPLAY

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
90       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

SIGNALS

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

BUGS

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
104       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

SPECIFICATIONS

112       freedesktop.org      System      Tray      Protocol       Specification
113http://standards.freedesktop.org/systemtray-spec/systemtray-
114       spec-0.3.html⟩
115
116       freedesktop.org         XEmbed          Protocol          Specification
117http://standards.freedesktop.org/xembed-spec/xembed-spec-0.5.html
118

AUTHORS

120       wmsystemtray was written by Brad Jorsch <anomie@users.sourceforge.net>.
121
122       Email  regarding  wmsystemtray  should  be sent to anomie@users.source‐
123       forge.net.
124

INSPIRATION

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
136
137
138                               January 22, 2022                wmsystemtray(1)
Impressum