systray

System tray icons via the StatusNotifierItem protocol.

Add it to your layout with systray:

bar:
  layout:
    - monitor: "*"
      right: [systray]

General

Field	Type	Default	Description
icon-scale	Size	1	Tray item icon size. Accepts a scale multiplier or pixels (e.g. "20px").
item-gap	Size	0.25	Gap between tray items. Accepts a scale multiplier or pixels (e.g. "4px").
internal-padding	Size	0.5	Padding at the ends of the container. Accepts a scale multiplier or pixels (e.g. "8px").
blacklist	array of string	[]	Glob patterns for tray items to hide.
overrides	array of TrayItemOverride	[]	Custom icon and color overrides.
border-show	bool	false	Display border around container.
border-color	ColorValue	"border-accent"	Border color token.
button-bg-color	ColorValue	"bg-surface-elevated"	Container background color token.

More about internal-padding

Applies to left/right edges for horizontal bars, or top/bottom edges for vertical bars.

More about blacklist

Matches against item ID or title. Example: ["*discord*", "Steam"]

More about overrides

First matching override wins. Supports glob patterns.

modules:
  systray:
    overrides:
      - name: "*discord*"
        icon: si-discord-symbolic
        color: blue

Default configuration

modules:
  systray:
    icon-scale: 1.0
    item-gap: 0.25
    internal-padding: 0.5
    blacklist: []
    overrides: []
    border-show: false
    border-color: border-accent
    button-bg-color: bg-surface-elevated