STALONETRAY(1)

NAME
stalonetray - stand-alone system tray (notification area) implementation. This document covers 1.2.0 version of stalonetray.

SYNOPSIS
  .HP u
  stalonetray
   [option...]

DESCRIPTION
  .PP Stalonetray is a stand-alone system tray (notification area) for X Window System/X11 (e.g. XOrg or XFree86). It has minimal build and run-time dependencies: an X11 lib only. Complete XEMBED support is under development. Stalonetray works with virtually any EWMH-compliant window manager.
  .PP The behaviour and the look of stalonetray can be configured either via command line options or via configuration file. As usual, command-line options have precedence over options that are specified in the configuration file.
  .PP Names of command line parameter may have two variants: short (-o) and long (--option). Write -ovalue or -o value to pass a value using the short name of a parameter; to pass a value using a long name, write --option value or --option=value. All flag-like parameters have optional boolean value that when ommited is assumed to be "true". Write "true", "yes", "1", for positive boolean values, and "false", "no", "0" for negative ones.
  .PP Default configuration file is $HOME/.stalonetrayrc. If it is not found, then $XDG_CONFIG_HOME/stalonetrayrc is checked for. A configuration file contains case-insensetive keyword-argument pairs, one per line. Lines starting with '#' and empty lines are ignored. Alternatively, confiuration file can specified via -c or --config command-line options.
  .PP Stalonetray can be configured to write diagnostic log messages to the standard error stream.
  .PP Below is the list of possible command line/configuration file options. Options starting with hyphens are command-line parameters others are configuration file keywords. Options that are new in 1.2.0 version are marked with "NEW in 1.2.0".

OPTIONS

  .PP -bg color, --background color, background color

      Use color for tray`s background. color can be specified as an HTML hex triplet or as a name from rgb.txt (note that '#' must be quoted). Default value: #777777.
      .RE
      .PP -c filename, --config filename

          Read configuration from filename instead of default $HOME/.stalonetrayrc.
          .RE
          .PP -d decspec, --decorations decspec, decorations decspec

              Specify visiblie tray window decorations. Possible values for decspec are: all, title, border, none (default).
              .RE
              .PP -display display, display display

                  Use X display display.
                  .RE
                  .PP --dockapp-mode [mode], dockapp_mode [mode]

                      Set dockapp mode, which can be either simple for e.g. OpenBox, wmaker for WindowMaker, or none (default).
                      .RE
                      .PP -f [level], --fuzzy-edges [level], fuzzy_edges [level]

                          Enable fuzzy edges of tray window and set fuzziness level which can range from 0 (disabled, default) to 3. When ommited, the value of level defaults to 2.
                          .RE
                          .PP --geometry geometry_spec, geometry geometry_spec

                              Set tray`s initial geometry to geometry_spec, specified in standard X notation: widthxheight[+x[+y]], where width and height are specified in icon slot multiples. Default value: 1x1+0-0.
                              .RE
                              .PP --grow-gravity gravity, grow_gravity gravity
                                    Specify icon positioning gravity (eigher N, S, W, E, NW, NE, SW, SE). Grow gravity specifies directions in which the tray's window may grow. For instance, if you specify NW the tray's window will grow down vertically and to the right horizontally (these are sides that are opposite to upper-left or North-West corner of the window); with W the tray's window will grow horizontally to the left side only, and it will vertically grow both upwards and downwards maintaining position of its center. Please note that the latter behaviour is new in 0.8. Default value: NW.
                                 .RE
                                  .PP --icon-gravity gravity, icon_gravity gravity

                                      Specify icon positioning gravity (either NW, NE, SW, SE). If you specify, e.g SW, then icons will appear starting from the lower-left corner of the tray's window. Default value: NW.
                                      .RE
                                      .PP -i n, --icon-size n, icon_size n

                                          Set default icon size to n. Default value: 24. Minimum: 16.
                                          .RE
                                          .PP -h, --help

                                              Show help message.
                                              .RE
                                              .PP ignore_classes classes

                                                  Set X11 window class names to be ignored by stalonetray. Class names are separate arguments: class1 class2 ....
                                                  .RE
                                                  .PP --log-level level, log_level level

                                                      Set the amount of info to be output by stalonetray to the standard output. Possible values for level: err (default), info, and trace. For the trace option to be available, stalonetray must be configured with --enable-debug at build-time.
                                                      .RE
                                                      .PP --kludges kludge [,kludge...]

                                                          Enable specific kludges to work around non-conforming WMs and/or stalonetray bugs. Argument is a comma-separated list of:

                                                            • fix_window_pos — fix tray window position on erroneous moves by WM

                                                            • force_icons_size — ignore resize events on all icons; force their size to be equal to icon_size

                                                            • use_icons_hints — use icon window hints to determine icon size
                                                          .sp

                                                          .RE
                                                          .PP --max-geometry geometry_spec, max_geometry geometry_spec

                                                              Set tray`s maximal geometry to geometry_spec Default value: 0x0, no limit.
                                                              .RE
                                                              .PP -m n, --monitor n, monitor n

                                                                  Set target monitor to n. Default value: 0.
                                                                  .RE
                                                                  .PP --no-shrink, no_shrink [bool]

                                                                      Do not shrink tray window back after icon removal. Useful when tray is swallowed by another window like FvwmButtons. Default value: false.
                                                                      .RE
                                                                      .PP -p, --parent-bg, parent_bg [bool]

                                                                          Use the parent's window as a background of the tray's window. Default value: false.
                                                                          .RE
                                                                          .PP --pixmap-bg path_to_xpm, pixmap_bg path_to_xpm

                                                                              Use the pixmap from an XPM file specified by path_to_xpm for the tray`s window background (pixmap will be tiled to fill the entire window).
                                                                              .RE
                                                                              .PP -r name, --remote-click-icon name

                                                                                  Remote control/click. When this option is specified, stalonetray sends a fake click to the icon with a window named name and exits. The icon is searched for in the currently active tray for the current screen. By default, stalonetray sends a single click with the 1st mouse button to the center of the icon. See the options below for additional information on how to alter the defaults.
                                                                                  .RE
                                                                                  .PP --remote-click-button n

                                                                                      Sets the remote click's button number to n (in the X11 numbering order).
                                                                                      .RE
                                                                                      .PP --remote-click-position xxy

                                                                                          Sets the remote click's position.
                                                                                          .RE
                                                                                          .PP --remote-click-type type

                                                                                              Sets the remote click's type. Possible values: single and double.
                                                                                              .RE
                                                                                              .PP -s n, --slot-size w[xw], slot_size w[xw]

                                                                                                  Set grid slot width to w and height to b, both of which cannot be less then icon_size. By default, the slot size is the same as the icon size. If omitted, height is set to be same as width.
                                                                                                  .RE
                                                                                                  .PP --scrollbars mode, scrollbars mode

                                                                                                      Set scrollbar mode. Possible values: vertical, horizontal, all, or none (default). Scrollbars appear as additional space at tray borders that can be clicked to scroll icon area. Mouse wheel also works.
                                                                                                      .RE
                                                                                                      .PP --scrollbars-highlight mode, scrollbars_highlight mode

                                                                                                          Set scrollbars highlight mode. Possible values: a color spec, or disable.
                                                                                                          .RE
                                                                                                          .PP --scrollbars-size n, scrollbars_size n

                                                                                                              Set scrollbar size to n pixels. By default, the size is 1/4 of slot_size.
                                                                                                              .RE
                                                                                                              .PP --scrollbars-step n, scrollbars_step n

                                                                                                                  Set scrollbar step to n pixels. Default is 1/2 of slot_size.
                                                                                                                  .RE
                                                                                                                  .PP --scroll-everywhere, scroll_everywhere [bool]

                                                                                                                      Enable scrolling outside of the scrollbars too. Default value: false.
                                                                                                                      .RE
                                                                                                                      .PP --drag-reorder [bool], drag_reorder [bool]

                                                                                                                          Allow reordering icons by holding the drag modifier and dragging them with the left mouse button. Default value: true.
                                                                                                                          .RE
                                                                                                                          .PP --drag-modifier mod, drag_modifier mod

                                                                                                                              Keyboard modifier that must be held to start a drag. Accepted values: alt, shift, ctrl, super, or none. Default value: alt. Setting this to none lets any Button1 drag start a reorder, which will also fire a click on the icon.
                                                                                                                              .RE
                                                                                                                              .PP --remember-icon-order [bool], remember_icon_order [bool]

                                                                                                                              Persist the icon order across tray restarts. On startup the previous order is restored as icons redock; applications that are no longer running are dropped, and icons that appear afterwards follow the tray's gravity. The order is keyed by WM_CLASS (window ids are not stable across a restart), with _NET_WM_PID distinguishing several icons that share a class, and tied to the current X session, so it is discarded after a full X restart. Default value: true.
                                                                                                                              .RE
                                                                                                                              .PP --icon-order-file path, icon_order_file path

                                                                                                                              Path to the icon order state file. Defaults to $XDG_STATE_HOME/stalonetray/order-screen (falling back to ~/.local/state/stalonetray/).
                                                                                                                              .RE
                                                                                                                              .PP --icon-order-timeout n, icon_order_timeout n

                                                                                                                              Seconds to wait at startup for icons to redock before settling on the restored order. The wait ends early once every remembered icon has returned. Default value: 10.
                                                                                                                              .RE
                                                                                                                              .PP --skip-taskbar, skip_taskbar [bool]

                                                                                                                              Hide tray`s window from the taskbar. Default value: false.
                                                                                                                              .RE
                                                                                                                              .PP --sticky, sticky [bool]

                                                                                                                              Make tray`s window sticky across multiple desktops/pages. Default value: false.
                                                                                                                              .RE
                                                                                                                              .PP --tint-color, tint_color [bool]

                                                                                                                              Set tinting color. Default value: white.
                                                                                                                              .RE
                                                                                                                              .PP --tint-level, tint_level [level]

                                                                                                                              Set tinting level. Default value: 0 (tinting disabled).
                                                                                                                              .RE
                                                                                                                              .PP -t, --transparent, transparent [bool]

                                                                                                                              Enable root transparency. Default value: false.
                                                                                                                              .RE
                                                                                                                              .PP -v, --vertical, vertical [bool]

                                                                                                                              Use vertical layout of icons (horizontal is used by default).
                                                                                                                              .RE
                                                                                                                              .PP --window-layer layer, window_layer layer

                                                                                                                              Sets the EWMH-compliant layer of tray`s window. Possible values for layer: bottom, normal, top. Default value: normal.
                                                                                                                              .RE
                                                                                                                              .PP --window-strut mode, window_strut mode

                                                                                                                              Enable window struts for tray window (to avoid covering of tray window by maximized windows). Mode defines to which screen border tray window will be attached. It can be either top, bottom, left, right, none, or auto (default).
                                                                                                                              .RE
                                                                                                                              .PP --window-type type, window_type type

                                                                                                                              Sets the EWMH-compliant type of tray`s window. Possible values for type: desktop, dock, normal, toolbar, utility. Default value: dock.
                                                                                                                              .RE
                                                                                                                              .PP --xsync, xsync [bool]

                                                                                                                              Operate on X server synchronously (SLOW, turned off by default).
                                                                                                                              .RE

DEPRECATIONS

  .PP As of stalonetray 0.8, the following command line and configuration file parameters are deprecated:

  .PP --dbg-level, dbg_level

      Please use --log-level instead.
      .RE
      .PP --max-tray-width, --max-tray-height, max_tray_width, max_tray_height

          Please use --max-geometry instead.

          .RE
          .PP -w, --withdrawn, withdrawn

              Please use --dockapp-mode instead.

              .RE
              .PP --respect-icon-hints, respect_icon_hints

                  Please use --kludges with use_icon_hints parameter instead.
                  .RE

FILES

$HOME/.stalonetrayrc — default configuration file.

BUGS

There are some, definetly.

If you need support, the best way to get it is open an issue at the stalonetray github page[1] or to e-mail me directly at <busa_ru@users.sourceforge.net>.

If you have found a bug, please try to reproduce it with the log level set to trace and redirect standard error stream to a file. Then attach the file to a github issue or to an e-mail. If the issue is intermittent, attach two log files -- one with the good and one with the bad behavior. If you have installed stalonetray from a package repository, you can also file a bug in the respective bug tracking system.

AUTHOR

Roman Dubtsov

NOTES

1.  github page
    https://github.com/kolbusa/stalonetray