stalonetray
TLDR
Start stalonetray with default settings
SYNOPSIS
stalonetray [options]
DESCRIPTION
stalonetray is a stand-alone system tray (notification area) implementation for X11. It provides a minimalist tray that works with any EWMH-compliant window manager, making it ideal for lightweight setups or window managers without built-in system trays.
The tray supports the freedesktop.org System Tray Protocol and XEMBED specification for embedding application icons. It can be positioned anywhere on screen and configured to reserve space (struts) so other windows don't overlap it.
Configuration can be done via command-line options or a configuration file at ~/.stalonetrayrc. The file uses keyword-argument pairs with command-line options taking precedence.
PARAMETERS
-bg, --background color
Tray background color (hex triplet or X11 color name).-i, --icon-size n
Default icon size in pixels. Default: 24, minimum: 16.--icon-gravity gravity
Icon positioning gravity: NW, NE, SW, or SE. Default: NW.--grow-gravity gravity
Direction for tray growth: NW, NE, SW, SE, N, S, E, or W.--geometry geometry
Initial tray window geometry (WIDTHxHEIGHT+X+Y).--max-geometry geometry
Maximum tray dimensions.--window-type type
EWMH window type: desktop, dock, normal, toolbar, utility. Default: dock.--window-strut mode
Reserve screen space: auto, top, bottom, left, right, or none.-d, --dockapp-mode mode
Dockapp mode: none, simple, or wmaker.--slot-size size
Grid slot size for icon placement.--sticky
Make tray window appear on all desktops.--skip-taskbar
Remove tray window from taskbar.--kludges list
Enable workarounds: fixwindowpos, forceiconssize, useiconshints.--log-level level
Logging verbosity: err, info, or trace.-c, --config file
Configuration file path.
CAVEATS
Some applications may not properly support the system tray protocol, requiring --kludges options. Window type dock may behave differently across window managers. Build requires only Xlib and optionally libXinerama. The trace log level requires building with --enable-debug.
HISTORY
stalonetray was created as a minimal, dependency-free system tray implementation for X11. It fills the need for a system tray in window managers that don't provide one natively, such as i3, bspwm, or dwm. The project follows the freedesktop.org specifications for system tray interoperability.
