1STALONETRAY(1) User Commands STALONETRAY(1)
2
6 stalonetray - stand-alone system tray (notification area)
7 implementation. This document covers 0.7.6 version of stalonetray.
8
10 stalonetray [option...]
11
13 Stalonetray is a stand-alone system tray (notification area) for X
14 Window System/X11 (e.g. XOrg or XFree86). It has minimal build and
15 run-time dependencies: an X11 lib only. Complete XEMBED support is
16 under development. Stalonetray works with virtually any EWMH-compliant
17 window manager.
18 The behaviour and the look of stalonetray can be configured either via
20 command line options or via configuration file. As usual, command-line
21 options have precedence over options that are specified in the
22 configuration file.
23 Names of command line parameter may have two variants: short (–o) and
25 long (––option). Write –ovalue or –o value to pass a value using the
26 short name of a parameter; to pass a value using a long name, write
27 ––option value or ––option=value. All flag-like parameters have
28 optional boolean value that when ommited is assumed to be "true". Write
29 "true", "yes", "1", for positive boolean values, and "false", "no", "0"
30 for negative ones. Please note, that a value cannot start with "-".
31 This limitation is to be fixed in future releases.
32 Default configuration file is $HOME/.stalonetrayrc. A configuration
34 file contains case-insensetive keyword-argument pairs, one per line.
35 Lines starting with ´#´ and empty lines are ignored. Alternatively,
36 confiuration file can specified via –c or ––config command-line
37 options.
38 Below is the list of possible command line/configuration file options.
40 Options starting with hyphens are command-line parameters others are
41 configuration file keywords. Options that are new in 0.7.6 version are
42 marked with "NEW in 0.7.6".
43
45 –display display, display display
46 Use X display display.
47 ––dbg–level n, dbg_level n
49 Set the level of debug output to n (stalonetray must be compiled
50 with ––enable–debug for this option to have effect.) Default value:
51 4.
52 –bg color, ––background color, background color
54 Use color for tray`s background. color can be specified as an HTML
55 hex triplet or as a name from rgb.txt (note that ´#´ must be
56 quoted). Default value: #777777.
57 –c filename, ––config filename
59 Read configuration from filename instead of default
60 $HOME/.stalonetrayrc.
61 –d decspec, ––decorations decspec, decorations decspec
63 Specify visiblie tray window decorations. Possible values for
64 decspec are: all, title, border, none (default). This option is NEW
65 in 0.7 and replaces now deprecated no_deco, no_title, and no_border
66 options.
67 –f [level], ––fuzzy-edges [level], fuzzy_edges [level]
69 Enable fuzzy edges of tray window and sets fuzziness level. (NEW in
70 0.7); level ranges from 0 (disabled, default) to 3. When ommited,
71 level defaults to 2.
72 ––geometry geometry_spec, geometry geometry_spec
74 Set tray`s initial geometry to geometry_spec, specified in standard
75 X notation: widthxheight[+x[+y]]. Default value: 124x24+0-0.
76 ––grow–gravity gravity, grow_gravity gravity
78 Specify icon positioning gravity (one of N, S, W, E, NW, NE, SW,
79 SE). Grow gravity specifies directions in which tray may and will
80 grow. For instance, if you specify W, tray will be allowed to grow
81 to the left (oppisite to West) side only; NW will allow tray to
82 grow down and to the right (these are sides, that are opposite to
83 upper-left, or North-West, corner). Default value: NE.
84 ––icon–gravity gravity, icon_gravity gravity
86 Specify icon positioning gravity (one of NW, NE, SW, SE). If you
87 specify, for instance, SW, icons will appear starting from the
88 lower-left corner of stalonetray window. Default value: NE.
89 –i n, ––icon–size n, icon_size n
91 Set basic icon size to n. Default value: 24.
92 ––ignore–icon–resize, ignore_icon_resize [bool]
94 Ignore icon resizing events, effectively forcing all icons
95 dimensions to be icon_size x icon_size. Default value: false.
96 –h, ––help
98 Show help message.
99 ––max–width n, max_width n
101 Set tray`s maximal width to n (0 means no limit). Default value: 0.
102 ––max–height n, max_height n
104 Set tray`s maximal height to n (0 means no limit). Default value:
105 0.
106 ––no–shrink, no_shrink [bool]
108 Do not shrink tray window back after icon removal. Useful when tray
109 is swallowed by another window like FvwmButtons. Default value:
110 false.
111 –p, ––parent–bg, parent_bg [bool]
113 Use parent for background. Default value: false.
114 ––pixmap–bg path_to_xpm, pixmap_bg path_to_xpm
116 Use pixmap from an XPM file specified by path_to_xpm for tray`s
117 background (pixmap will be tiled to fill the whole window).
118 ––respect–icon–hints, respect_icon_hints [bool]
120 Do respect icon window min_width/min_height size hints. This may
121 help with unusually-sized icons, which fail to resize themselves
122 after being resized to icon_size x icon_size. Note, that if
123 stalonetray is configured to ignore icon resize events, this option
124 has no effect. Default value: false.
125 ––skip–taskbar, skip_taskbar [bool]
127 Hide tray`s window from the taskbar. Default value: false.
128 ––sticky, sticky [bool]
130 Make tray`s window sticky across multiple desktops/pages. Default
131 value: false.
132 ––tint–color, tint_color [bool]
134 Set tinting color. Default value: white.
135 ––tint–value, tint_color [bool]
137 Set tinting level. Default value: 0 (tinting disabled).
138 –t, ––transparent, transparent [bool]
140 Enable root transparency. Default value: false.
141 –v, ––vertical, vertical [bool]
143 Use vertical layout of icons (horizontal is used by default).
144 ––window-layer layer, window_layer layer
146 Sets the EWMH–compliant layer of tray`s window. Possible values for
147 layer: bottom, normal, top. Default value: normal.
148 ––window-type type, window_type type
150 Sets the EWMH–compliant type of tray`s window. Possible values for
151 type: dock, normal, toolbar, utility. Default value: dock.
152 –w, ––withdrawn, withdrawn [bool]
154 Start in withdrawn (dockapp) mode. NEW in 0.7, prior to that was
155 default mode.
156 ––xsync, xsync [bool]
158 Operate on X server synchronously (SLOW, turned off by default).
159
161 $HOME/.stalonetrayrc — default configuration file.
162
164 There are some, definetly.
165 If you have found a bug, please try to reproduce it with debug level
167 set to 8 and send the log file to me: <busa_ru@users.sourceforge.net>.
168 If you need support, the best way to get it is also to e–mail me
169 directly. If you have installed stalonetray from distribution
170 repository, you can also file a bug there.
171stalonetray 0.7.6 01/07/2008 STALONETRAY(1)