1STALONETRAY(1) User Commands STALONETRAY(1)
2
6 stalonetray - stand-alone system tray (notification area)
7 implementation. This document covers 0.8 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.
31 Default configuration file is $HOME/.stalonetrayrc. A configuration
33 file contains case-insensetive keyword-argument pairs, one per line.
34 Lines starting with ´#´ and empty lines are ignored. Alternatively,
35 confiuration file can specified via -c or --config command-line
36 options.
37 Below is the list of possible command line/configuration file options.
39 Options starting with hyphens are command-line parameters others are
40 configuration file keywords. Options that are new in 0.8 version are
41 marked with "NEW in 0.8".
42
44 -bg color, --background color, background color
45 Use color for tray`s background. color can be specified as an HTML
46 hex triplet or as a name from rgb.txt (note that ´#´ must be
47 quoted). Default value: #777777.
48 -c filename, --config filename
50 Read configuration from filename instead of default
51 $HOME/.stalonetrayrc.
52 -d decspec, --decorations decspec, decorations decspec
54 Specify visiblie tray window decorations. Possible values for
55 decspec are: all, title, border, none (default).
56 -display display, display display
58 Use X display display.
59 --dockapp-mode [mode], dockapp_mode [mode]
61 Set dockapp mode, which can be either simple for e.g. OpenBox,
62 wmaker for WindowMaker, or none (default).
63 -f [level], --fuzzy-edges [level], fuzzy_edges [level]
65 Enable fuzzy edges of tray window and sets fuzziness level which
66 can range from 0 (disabled, default) to 3. When ommited, level
67 defaults to 2.
68 --geometry geometry_spec, geometry geometry_spec
70 Set tray`s initial geometry to geometry_spec, specified in standard
71 X notation: widthxheight[+x[+y]]. Default value: 124x24+0-0.
72 --grow-gravity gravity, grow_gravity gravity
74 Specify icon positioning gravity (eigher N, S, W, E, NW, NE, SW,
75 SE). Grow gravity specifies directions in which tray may and will
76 grow. For instance, if you specify NW it will make tray grow down
77 vertically and to the right horizontally (these are sides that are
78 opposite to upper-left or North-West corner); with W tray will be
79 allowed to grow horizontally to the left (opposite to West) side
80 only and vertically it will grow equally both to the top and bottom
81 sides. Please note that the latter behaviour is new in 0.8. Default
82 value: NW.
83 --icon-gravity gravity, icon_gravity gravity
85 Specify icon positioning gravity (either NW, NE, SW, SE). If you
86 specify, for instance, SW, icons will appear starting from the
87 lower-left corner of stalonetray window. Default value: NW.
88 -i n, --icon-size n, icon_size n
90 Set basic icon size to n. Default value: 24. Minimal value: 16.
91 -h, --help
93 Show help message.
94 --log-level level, log_level level
96 Set the amount of info output by stalonetray. Possible values for
97 level: err (default), info, and trace. For trace to be available,
98 stalonetray must be configured with --enable-debug at build-time.
99 NEW in 0.8.
100 --kludges kludge [,kludge...]
102 Enable specific kludges to work around non-conforming WMs and/or
103 stalonetray bugs. NEW in 0.8. Argument is a comma-separated list
104 of:
105 · fix_window_pos — fix tray window position on erroneous moves by
107 WM
108 · force_icon_size — ignore resize events on all icons; force
110 their size to be equal to icon_size
111 · use_icon_hints — use icon window hints to determine icon size
113 --max-geometry geometry_spec, max_geometry geometry_spec
115 Set tray`s maximal geometry to geometry_spec Default value: 0x0, no
116 limit. NEW in 0.8.
117 --no-shrink, no_shrink [bool]
119 Do not shrink tray window back after icon removal. Useful when tray
120 is swallowed by another window like FvwmButtons. Default value:
121 false.
122 -p, --parent-bg, parent_bg [bool]
124 Use parent for background. Default value: false.
125 --pixmap-bg path_to_xpm, pixmap_bg path_to_xpm
127 Use pixmap from an XPM file specified by path_to_xpm for tray`s
128 background (pixmap will be tiled to fill the whole window).
129 -r name, --remote-click-icon name
131 Remote control/click. When this option is specified, stalonetray
132 sends fake click to icon with window named name and exits. Icon is
133 searched for in currently active tray for given screen. By defauld,
134 single click with 1st mousr button is made to the center of the
135 icon. See options below for information on how to alter defaults.
136 NEW in 0.8.
137 --remote-click-button n
139 Sets remote click button number to n (in X11 numbering order). NEW
140 in 0.8.
141 --remote-click-position xxy
143 Sets remote click position. NEW in 0.8.
144 --remote-click-type type
146 Sets remote click type which can be either single or double. NEW in
147 0.8.
148 -s n, --slot-size n, slot_size n
150 Set grid slot size to n. Cannot be less then icon_size which is
151 default value unless specified. NEW in 0.8.
152 --scrollbars mode, scrollbars mode
154 Set scrollbar mode, either vertical, horizontal, all, or none
155 (default). Scrollbars appear as additional space at tray borders
156 that can be clicked to scroll icon area. Mouse wheel also works.
157 NEW in 0.8.
158 --scrollbars-highlight mode, scrollbars_highlight mode
160 Set scrollbars highlight mode, either color spec, or disable. NEW
161 in 0.8.
162 --scrollbars-size n, scrollbars_size n
164 Set scrollbar size to n pixels. Default is quarter of slot_size.
165 NEW in 0.8.
166 --scrollbars-step n, scrollbars_step n
168 Set scrollbar step to n pixels. Default is half of slot_size. NEW
169 in 0.8.
170 --skip-taskbar, skip_taskbar [bool]
172 Hide tray`s window from the taskbar. Default value: false.
173 --sticky, sticky [bool]
175 Make tray`s window sticky across multiple desktops/pages. Default
176 value: false.
177 --tint-color, tint_color [bool]
179 Set tinting color. Default value: white.
180 --tint-level, tint_level [level]
182 Set tinting level. Default value: 0 (tinting disabled).
183 -t, --transparent, transparent [bool]
185 Enable root transparency. Default value: false.
186 -v, --vertical, vertical [bool]
188 Use vertical layout of icons (horizontal is used by default).
189 --window-layer layer, window_layer layer
191 Sets the EWMH-compliant layer of tray`s window. Possible values for
192 layer: bottom, normal, top. Default value: normal.
193 --window-strut mode, window_strut mode
195 Enable window struts for tray window (to avoid covering of tray
196 window by maximized windows). Mode defines to which screen border
197 tray window will be attached. It can be either top, bottom, left,
198 right, none, or auto (default).
199 --window-type type, window_type type
201 Sets the EWMH-compliant type of tray`s window. Possible values for
202 type: desktop, dock, normal, toolbar, utility. Default value: dock.
203 --xsync, xsync [bool]
205 Operate on X server synchronously (SLOW, turned off by default).
206
208 As of stalonetray 0.8 following command line and configuration
209 parameters are depricated:
210 --dbg-level, dbg_level
212 Please use --log-level instead.
213 --max-tray-width, --max-tray-height, max_tray_width, max_tray_height
215 Please use --max-geometry instead.
216 -w, --withdrawn, withdrawn
218 Please use --dockapp-mode instead.
219 --respect-icon-hints, respect_icon_hints>
221 Please use --kludges with use_icon_hints parameter instead.
222
224 $HOME/.stalonetrayrc — default configuration file.
225
227 There are some, definetly.
228 If you have found a bug, please try to reproduce it with log level set
230 to trace and send the log file to me: <busa_ru@users.sourceforge.net>.
231 If you need support, the best way to get it is also to e-mail me
232 directly. If you have installed stalonetray from distribution
233 repository, you can also file a bug in respective bug tracking
234 database.
235stalonetray 0.8 10/21/2009 STALONETRAY(1)