Skip to content

systray

System tray icons via the StatusNotifierItem protocol.

Add it to your layout with systray:

toml
[[bar.layout]]
monitor = "*"
right = ["systray"]

General

FieldTypeDefaultDescription
icon-scaleScaleFactor1Scale multiplier for tray item icons.
item-gapSpacing0.25Gap between tray items.
internal-paddingSpacing0.5Padding at the ends of the container.
blacklistarray of string[]Glob patterns for tray items to hide.
overridesarray of TrayItemOverride[]Custom icon and color overrides.
border-showboolfalseDisplay border around container.
border-colorColorValue"border-accent"Border color token.
button-bg-colorColorValue"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.

toml
[[module.systray.overrides]]
name = "*discord*"
icon = "si-discord-symbolic"
color = "blue"

Default configuration

toml
[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"

Released under the MIT License.