Skip to content

Tray icon support on Wayland (Hyprland) #2003

@simonbcn

Description

@simonbcn

Feature Request: Tray icon support on Wayland

Current behavior

The tray icon feature works on X11/Windows (implemented in #1352), but on Wayland compositors (e.g. Hyprland) the tray icon does not appear and minimizing/closing to tray is not possible.

Expected behavior

  • Minimize to tray icon when clicking the minimize button (optional, via settings)
  • Close to tray icon when clicking the close button (optional, via settings)
  • Tray icon should be visible and functional on Wayland compositors that support the StatusNotifierItem (SNI) protocol (KDE Plasma, Hyprland + tray applet, etc.)

Technical context

Wayland does not use the legacy X11 _NET_SYSTEM_TRAY protocol. Instead, it relies on the StatusNotifierItem (SNI) / AppIndicator specification. Electron supports this via:

  • Tray API with --enable-features=UseOzonePlatform --ozone-platform=wayland flags
  • Or ensuring the app is launched with proper Wayland/XWayland environment

Most Wayland compositors with a tray (Waybar, swaybar, etc.) support SNI natively.

Environment

  • OS: Arch Linux
  • Compositor: Hyprland (Wayland)
  • Nuclear version: latest
  • Installation method: AUR

Why this is different from existing closed issues

Issues #932, #1149 were generic "minimize to tray" requests. This specifically targets the Wayland protocol incompatibility with the existing tray implementation, which is a distinct technical problem.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions