⚠️ tray is still in beta. There may be bugs. Breaking changes may occur.

Config

Addressed by tray

option	typeof	default	description
icon-size	integer		Defines the size of the tray icons.
show-passive-items	bool	false	Defines visibility of the tray icons with Passive status.
smooth-scrolling-threshold	double		Threshold to be used when scrolling.
spacing	integer		Defines the spacing between the tray icons.
reverse-direction	bool	false	Defines if new app icons should be added in a reverse order.
icons	object	{}	Override icon mapping for tray icons.

Icons

Each entry of icons must be app_name/app_id : icon_name/image_path mapping. icon_name can be a globally identified icon.

For now, it only works with actual image files, not font-based icons. It might not work for some electron apps (https://github.com/electron/electron/issues/40936).

Example:

"tray": {
    "icon-size": 21,
    "spacing": 10,
    "icons": {
        "blueman": "bluetooth",
        "TelegramDesktop": "$HOME/.local/share/icons/hicolor/16x16/apps/telegram.png"
    }
}

Style

• #tray
• #tray menu for the context menu
• #tray widget>image for icons
• #tray > .passive for icons with status Passive
• #tray > .active for icons with status Active
• #tray > .needs-attention for icons with status NeedsAttention