System tray icons never appear for Electron, Java, Qt and Wine apps
Cause is sound and the diagnosis via busctl --user list | grep StatusNotifier is right. I ran it on this Omarchy 4.0.0-1 / Hyprland 0.56.2 box and it prints org.kde.StatusNotifierWatcher owned by quickshell, and /usr/share/omarchy/shell/plugins/bar/widgets/Tray.qml does import Quickshell.Services.SystemTray. But three specifics in the fix are wrong. (1) The binary path is fabricated: the Arch file list for plasma-workspace 6.7.4-3 shows usr/bin/xembedsniproxy, not /usr/lib/xembedsniproxy, so the copy-pasteable Lua line launches nothing. The record's own cited source, hyprwm/Hyprland discussion 13083, just runs xembedsniproxy off PATH. (2) The window rule cannot match. The record matches class = "^xembedsniproxy$", but discussion 13083, fetched in full via the GitHub GraphQL API, says the leftover helper "commonly has an empty title" and its working rule matches xwayland true, title ^$, class ^$, initial_class ^$, initial_title ^$. (3) The parenthetical "Before KDE 6.7.0 the helper had an empty class and you had to match title/class ^$ instead" is invented precision with the sign flipped: plasma-workspace is currently 6.7.4 and the empty class/title is the present-day behaviour, not a pre-6.7.0 one. The no_blur claim is genuine. The discussion says "no_blur on is required, otherwise the window can remain visible as a faint blurred/dark rectangle even with opacity set to 0." Two more findings worth folding in: plasma-workspace ships etc/xdg/autostart/xembedsniproxy.desktop but KDE's copy of it is OnlyShowIn=KDE; with X-systemd-skip=true, so it will not autostart on a Hyprland/uwsm session (the explicit autostart really is needed), and plasma-xembedsniproxy.service has no [Install] section (only PartOf=graphical-session.target), so systemctl --user enable on it would fail. Config autostart is the correct route. Finally, the danger note's "there is no separately packaged xembedsniproxy" is true of the repos but there is a standalone AUR xembedsniproxy 6.7.2-0 whose deps are just kcoreaddons/kcrash/kdbusaddons/kwindowsystem/qt6-base/xcb-*, which avoids the whole Plasma stack. Verified libappindicator 12.10.1-2 and libayatana-appindicator 0.6.0-2 both exist in extra, so step 2 stands as written.
plasma-workspace pulls in a large chunk of the KDE Plasma stack (hundreds of MB of Qt/KF6 dependencies) purely to obtain one small binary. On a minimal Hyprland install decide whether that trade is worth it before installing. There is no separately packaged xembedsniproxy in the Arch repos.
Symptom
Discord, Nextcloud, KeePassXC, Insync and Steam all claim to "minimise to tray" but nothing ever shows up in the bar. Steam simply vanishes when I close its window and I cannot get it back. Under Wine/Proton (Battle.net, uTorrent) a tiny naked window containing the tray icons floats loose on the desktop instead of docking anywhere.
Cause
Wayland has no XEmbed system tray: the X11 _NET_SYSTEM_TRAY protocol that every classic tray icon used simply does not exist. On Wayland the bar must run a StatusNotifierItem (SNI/AppIndicator) *host*, and each app must publish an SNI on the session bus. GTK and Electron apps only publish an SNI if libappindicator is present at runtime. Wine, Java/Swing SystemTray, and older Qt4-era apps only ever speak XEmbed and will never publish one. XWayland gives those apps an X server but no tray host to dock into, which is why Wine draws its own floating icon window.
Fix
- Confirm something is hosting SNI. A bar with a tray module (Waybar's
tray, Omarchy 4's Quickshell bar) registers the watcher:
busctl --user list | grep -i StatusNotifier
You want to see org.kde.StatusNotifierWatcher. On a stock Omarchy 4 session this is already there and owned by quickshell. The bar's tray widget (/usr/share/omarchy/shell/plugins/bar/widgets/Tray.qml) is an SNI host, so skip to step 2. If the watcher is absent, no bar is hosting the tray. For Waybar, add the module:
// ~/.config/waybar/config.jsonc
"modules-right": ["tray", "clock"],
"tray": { "icon-size": 18, "spacing": 8 }
and restart it: pkill waybar; waybar & disown
- Give GTK/Electron apps the AppIndicator library they probe for:
sudo pacman -S --needed libappindicator libayatana-appindicator
Restart the app afterwards. It only probes at startup.
- For XEmbed-only apps (Wine/Proton launchers, Java/Swing, Steam), run KDE's XEmbed→SNI proxy. Prefer the standalone AUR package, which pulls only a handful of KF6/Qt6 libraries:
yay -S xembedsniproxy
If you would rather stay in the official repos, the same binary ships in plasma-workspace. See the danger note before choosing this:
sudo pacman -S --needed plasma-workspace
Either way the binary lands at /usr/bin/xembedsniproxy. Confirm with command -v xembedsniproxy.
- Autostart it. The
.desktopfile thatplasma-workspaceinstalls isOnlyShowIn=KDE;, so it will **not** fire on a Hyprland/uwsm session, and the bundledplasma-xembedsniproxy.servicehas no[Install]section sosystemctl --user enableon it fails. Start it from your Hyprland config instead:
-- ~/.config/hypr/hyprland.lua
hl.on("hyprland.start", function()
hl.exec_cmd("xembedsniproxy")
end)
- Hide the leftover helper window. Once the proxy is running, XWayland still leaves a small blank helper window with an **empty class and title**, which Hyprland draws as a faint blurred rectangle:
hl.window_rule({
name = "hide-xembed-tray-helper",
match = {
xwayland = true,
class = "^$",
title = "^$",
initial_class = "^$",
initial_title = "^$"
},
float = true,
no_focus = true,
no_initial_focus = true,
no_anim = true,
no_blur = true,
opacity = 0.0
})
no_blur is required. With opacity alone the helper stays visible as a dark smear. Note that this rule is deliberately broad: any XWayland window that opens with no class and no title will also be hidden. If something legitimate disappears, narrow the match.
Apply with hyprctl reload.
- Restart the offending app and re-check
busctl --user list | grep StatusNotifierItem. Each tray-owning app should now hold a name there.
Verify
busctl --user list | grep StatusNotifierItem lists one bus name per app that should have a tray icon, and busctl --user list | grep StatusNotifierWatcher shows the host. The icons then appear in the bar. If a name is listed on the bus but no icon draws, the problem is in the bar (a known GDBus property-caching bug affects some Electron 43+ items in Waybar), not in the app.