NAME
stalonetray - stand-alone system tray (notification area)
implementation. This document covers 0.8 version of stalonetray.
SYNOPSIS
stalonetray [option...]
DESCRIPTION
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.
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.
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.
Default configuration file is $HOME/.stalonetrayrc. 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.
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 0.8 version are
marked with "NEW in 0.8".
OPTIONS
-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.
-c filename, --config filename
Read configuration from filename instead of default
$HOME/.stalonetrayrc.
-d decspec, --decorations decspec, decorations decspec
Specify visiblie tray window decorations. Possible values for
decspec are: all, title, border, none (default).
-display display, display display
Use X display display.
--dockapp-mode [mode], dockapp_mode [mode]
Set dockapp mode, which can be either simple for e.g. OpenBox,
wmaker for WindowMaker, or none (default).
-f [level], --fuzzy-edges [level], fuzzy_edges [level]
Enable fuzzy edges of tray window and sets fuzziness level which
can range from 0 (disabled, default) to 3. When ommited, level
defaults to 2.
--geometry geometry_spec, geometry geometry_spec
Set tray‘s initial geometry to geometry_spec, specified in standard
X notation: widthxheight[+x[+y]]. Default value: 124x24+0-0.
--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 tray may and will
grow. For instance, if you specify NW it will make tray grow down
vertically and to the right horizontally (these are sides that are
opposite to upper-left or North-West corner); with W tray will be
allowed to grow horizontally to the left (opposite to West) side
only and vertically it will grow equally both to the top and bottom
sides. Please note that the latter behaviour is new in 0.8. Default
value: NW.
--icon-gravity gravity, icon_gravity gravity
Specify icon positioning gravity (either NW, NE, SW, SE). If you
specify, for instance, SW, icons will appear starting from the
lower-left corner of stalonetray window. Default value: NW.
-i n, --icon-size n, icon_size n
Set basic icon size to n. Default value: 24. Minimal value: 16.
-h, --help
Show help message.
--log-level level, log_level level
Set the amount of info output by stalonetray. Possible values for
level: err (default), info, and trace. For trace to be available,
stalonetray must be configured with --enable-debug at build-time.
NEW in 0.8.
--kludges kludge [,kludge...]
Enable specific kludges to work around non-conforming WMs and/or
stalonetray bugs. NEW in 0.8. Argument is a comma-separated list
of:
· fix_window_pos — fix tray window position on erroneous moves by
WM
· force_icon_size — ignore resize events on all icons; force
their size to be equal to icon_size
· use_icon_hints — use icon window hints to determine icon size
--max-geometry geometry_spec, max_geometry geometry_spec
Set tray‘s maximal geometry to geometry_spec Default value: 0x0, no
limit. NEW in 0.8.
--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.
-p, --parent-bg, parent_bg [bool]
Use parent for background. Default value: false.
--pixmap-bg path_to_xpm, pixmap_bg path_to_xpm
Use pixmap from an XPM file specified by path_to_xpm for tray‘s
background (pixmap will be tiled to fill the whole window).
-r name, --remote-click-icon name
Remote control/click. When this option is specified, stalonetray
sends fake click to icon with window named name and exits. Icon is
searched for in currently active tray for given screen. By defauld,
single click with 1st mousr button is made to the center of the
icon. See options below for information on how to alter defaults.
NEW in 0.8.
--remote-click-button n
Sets remote click button number to n (in X11 numbering order). NEW
in 0.8.
--remote-click-position xxy
Sets remote click position. NEW in 0.8.
--remote-click-type type
Sets remote click type which can be either single or double. NEW in
0.8.
-s n, --slot-size n, slot_size n
Set grid slot size to n. Cannot be less then icon_size which is
default value unless specified. NEW in 0.8.
--scrollbars mode, scrollbars mode
Set scrollbar mode, either 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.
NEW in 0.8.
--scrollbars-highlight mode, scrollbars_highlight mode
Set scrollbars highlight mode, either color spec, or disable. NEW
in 0.8.
--scrollbars-size n, scrollbars_size n
Set scrollbar size to n pixels. Default is quarter of slot_size.
NEW in 0.8.
--scrollbars-step n, scrollbars_step n
Set scrollbar step to n pixels. Default is half of slot_size. NEW
in 0.8.
--skip-taskbar, skip_taskbar [bool]
Hide tray‘s window from the taskbar. Default value: false.
--sticky, sticky [bool]
Make tray‘s window sticky across multiple desktops/pages. Default
value: false.
--tint-color, tint_color [bool]
Set tinting color. Default value: white.
--tint-level, tint_level [level]
Set tinting level. Default value: 0 (tinting disabled).
-t, --transparent, transparent [bool]
Enable root transparency. Default value: false.
-v, --vertical, vertical [bool]
Use vertical layout of icons (horizontal is used by default).
--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.
--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).
--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.
--xsync, xsync [bool]
Operate on X server synchronously (SLOW, turned off by default).
DEPRICATIONS
As of stalonetray 0.8 following command line and configuration
parameters are depricated:
--dbg-level, dbg_level
Please use --log-level instead.
--max-tray-width, --max-tray-height, max_tray_width, max_tray_height
Please use --max-geometry instead.
-w, --withdrawn, withdrawn
Please use --dockapp-mode instead.
--respect-icon-hints, respect_icon_hints>
Please use --kludges with use_icon_hints parameter instead.
FILES
$HOME/.stalonetrayrc — default configuration file.
BUGS
There are some, definetly.
If you have found a bug, please try to reproduce it with log level set
to trace and send the log file to me: <busa_ru@users.sourceforge.net>.
If you need support, the best way to get it is also to e-mail me
directly. If you have installed stalonetray from distribution
repository, you can also file a bug in respective bug tracking
database.