NAME

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

SYNOPSIS

       wmsystemtray [options]

DESCRIPTION

       wmsystemtray is a system tray using the freedesktop.org system tray protocol designed as a
       Window Maker dock app. It has the ability to display more than one  dock  window  to  make
       room  for more tray icons, and the ability to scroll through the icons if more are present
       than will fit.

OPTIONS

       -display <display name>
              Name of display to use.

       --help Display usage information.

       -V, --version
              Display the version number and exit.

       -v, --verbose
              Print more messages to the console. May be repeated.

       -q, --quiet
              Print fewer messages to the console. May be repeated.

       -s, --small
              Use 16x16 tray icons, instead of 24x24. In other words, fit 9 icons instead of 4 in
              one dock window.

       -w <n>, --windows <n>
              Specifies the number of dock windows to open. Each dock window is assigned a unique
              name    (i.e.    the    first    is    wmsystemtray.wmsystemtray0,    the    second
              wmsystemtray.wmsystemtray1,  and  so on), so they can be reliably positioned in the
              dock or clip.

       --id-windows
              Print the window's index number on the window, to make it easier to  dock  them  in
              the  right  order. Note that if there are enough tray icons active, this number may
              be covered up.

       --fill-rows
              Normally the first dock window is completely  filled  before  any  tray  icons  are
              placed  in  the  second.  This  option fills the top row of each dock window before
              placing any icons in the second row, which may make more sense if you  arrange  the
              dock windows horizontally.

       --arrows <place>
              Normally, every dock window has both left and right scrolling arrows at the bottom.
              Specifying --arrows horizontal places the left arrow only on the first  window  and
              the  right  arrow  only  on  the last, which may make more sense if the windows are
              arranged horizontally. --arrows vertical places the arrows only on the last window,
              which may make more sense if the windows are arranged vertically.

       -c <color>, --fgcolor <color>
              Specify  a  color  for  the  page indicator and --id-windows indicators, instead of
              black. Colors may be specified in any format recognized by  XParseColor  In  short,
              that's any color name in X's rgb.txt or an RGB color specified as "rgb:rr/gg/gg".

       --bgcolor <color>
              In  non-Window Maker mode, specify the color for the window background. The default
              is to shape the window to fit the  used  area  and  to  set  ParentRelative,  which
              attempts to copy whatever is behind the window.

       --non-wmaker
              Activate non-Window Maker mode. This provides limited support for using the program
              in window managers that don't do Window Maker-style dockapps; the application still
              sizes  itself  as  a 64x64 window, however, so you might be better served by a more
              traditional system tray.

DISPLAY

       The main portion of the dockapp has room for four 24x24 or nine 16x16 tray icons.  At  the
       bottom are left and right arrows for paging when more tray icons are available than can be
       displayed at once, with an indicator between showing the current "page" of icons and total
       number of pages currently available.

       In addition to left-clicking either scrolling arrows, the mouse's scroll wheel may be used
       on the bottom section to change pages.

SIGNALS

       SIGUSR1 and SIGUSR2 may be used to change pages. A program such as xbindkeys may  be  used
       to send these signals to wmsystemtray on appropriate key presses.

BUGS

       The  balloon  message  portion  of the freedesktop.org protocol is not implemented at this
       time. I've heard that the official Gnome system tray doesn't implement  this  either,  and
       most tray apps seem to directly use dbus desktop notifications service.

       Most  of  the  Xembed  specification  is  not  implemented, as it is not needed here.  For
       example, the only point to redirecting input focus is to allow the  outer  window  to  see
       input  events  (and  then the outer window has to forward those events to the embeds). But
       since we don't really care, we can just let the icons get events directly.  Similarly,  we
       don't take focus or activation, and we don't do accellerators.

SPECIFICATIONS

       freedesktop.org           System           Tray           Protocol           Specification
       ⟨http://standards.freedesktop.org/systemtray-spec/systemtray-spec-0.3.html⟩

       freedesktop.org XEmbed  Protocol  Specification  ⟨http://standards.freedesktop.org/xembed-
       spec/xembed-spec-0.5.html⟩

AUTHORS

       wmsystemtray was written by Brad Jorsch <anomie@users.sourceforge.net>.

       Email regarding wmsystemtray should be sent to anomie@users.sourceforge.net.

INSPIRATION

       When I finally decided to make use of some applications that work via system tray icons, I
       looked around for a tray for my preferred window manager. Some didn't  integrate  well  (I
       didn't  want a bar at the top or bottom of the screen), some dockapps couldn't handle more
       than 4 icons at all, some could do 4 icons with paging (and much crashing if  any  program
       was  killed),  some  could do more than 4 icons by creating arbitrary numbers of app icons
       (but undockable, because they were created "as needed"). So I decided  to  write  my  own,
       combining the best features into a stable app.

                                        February 22, 2014                         wmsystemtray(1)