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 -ovalue to pass a value using the
26 short name of a parameter; to pass a value using a long name, write
27 --optionvalue or --option=value. All flag-like parameters have optional
28 boolean value that when ommited is assumed to be "true". Write "true",
29 "yes", "1", for positive boolean values, and "false", "no", "0" for
30 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 set fuzziness level which can
66 range from 0 (disabled, default) to 3. When ommited, the value of
67 level 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]], where width and height are
72 specified in icon slot multiples. Default value: 1x1+0-0.
73 --grow-gravity gravity, grow_gravity gravity
75 Specify icon positioning gravity (eigher N, S, W, E, NW, NE, SW,
76 SE). Grow gravity specifies directions in which the tray's window
77 may grow. For instance, if you specify NW the tray's window will
78 grow down vertically and to the right horizontally (these are sides
79 that are opposite to upper-left or North-West corner of the
80 window); with W the tray's window will grow horizontally to the
81 left side only, and it will vertically grow both upwards and
82 downwards maintaining position of its center. Please note that the
83 latter behaviour is new in 0.8. Default value: NW.
84 --icon-gravity gravity, icon_gravity gravity
86 Specify icon positioning gravity (either NW, NE, SW, SE). If you
87 specify, e.g SW, then icons will appear starting from the
88 lower-left corner of the tray's window. Default value: NW.
89 -i n, --icon-size n, icon_size n
91 Set default icon size to n. Default value: 24. Minimum: 16.
92 -h, --help
94 Show help message.
95 --log-level level, log_level level
97 Set the amount of info to be output by stalonetray. Possible values
98 for level: err (default), info, and trace. For the trace option to
99 be available, stalonetray must be configured with --enable-debug at
100 build-time.
101 --kludges kludge [,kludge...]
103 Enable specific kludges to work around non-conforming WMs and/or
104 stalonetray bugs. Argument is a comma-separated list of:
105 · fix_window_pos — fix tray window position on erroneous moves by
107 WM
108 · force_icons_size — ignore resize events on all icons; force
110 their size to be equal to icon_size
111 · use_icons_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.
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 the parent's window as a background of the tray's window.
125 Default value: false.
126 --pixmap-bg path_to_xpm, pixmap_bg path_to_xpm
128 Use the pixmap from an XPM file specified by path_to_xpm for the
129 tray`s window background (pixmap will be tiled to fill the entire
130 window).
131 -r name, --remote-click-icon name
133 Remote control/click. When this option is specified, stalonetray
134 sends a fake click to the icon with a window named name and exits.
135 The icon is searched for in the currently active tray for the
136 current screen. By default, stalonetray sends a single click with
137 the 1st mouse button to the center of the icon. See the options
138 below for additional information on how to alter the defaults.
139 --remote-click-button n
141 Sets the remote click's button number to n (in the X11 numbering
142 order).
143 --remote-click-position xxy
145 Sets the remote click's position.
146 --remote-click-type type
148 Sets the remote click's type. Possible values: single and double.
149 -s n, --slot-size n, slot_size n
151 Set grid slot size to n, which cannot be less then icon_size. By
152 default, the slot size is the same as the icon size.
153 --scrollbars mode, scrollbars mode
155 Set scrollbar mode. Possible values: vertical, horizontal, all, or
156 none (default). Scrollbars appear as additional space at tray
157 borders that can be clicked to scroll icon area. Mouse wheel also
158 works.
159 --scrollbars-highlight mode, scrollbars_highlight mode
161 Set scrollbars highlight mode. Possible values: a color spec, or
162 disable.
163 --scrollbars-size n, scrollbars_size n
165 Set scrollbar size to n pixels. By default, the size is 1/4 of
166 slot_size.
167 --scrollbars-step n, scrollbars_step n
169 Set scrollbar step to n pixels. Default is 1/2 of slot_size.
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, the following command line and configuration
209 file parameters are deprecated:
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 the log level
230 set to trace and send the log file to me:
231 <busa_ru@users.sourceforge.net>. If you need support, the best way to
232 get it is also to e-mail me directly. If you have installed stalonetray
233 from a distribution repository, you can also file a bug in the
234 respective bug tracking database.
235
237 Roman Dubtsov
238stalonetray 0.8 03/04/2015 STALONETRAY(1)