2 Currently there is not a common way to create a systray menu compatible with all desktops.
4 [GtkStatusIcon](https://developer.gnome.org/gtk3/stable/GtkStatusIcon.html) has been deprecated since GTK 3.14.
5 So we must move to something else. Unfortunately, this "something else" is different from a desktop environment to another.
7 E.g.: read [this discussion](https://trac.transmissionbt.com/ticket/3685) for the same problem on Transmission client.
9 Yet, we cannot use gtk_window_present() from a systray menu, see issue [#542](https://gitlab.com/Remmina/Remmina/issues/542).
11 So, for each supported desktop environment, we must answer two questions:
13 Q1. Where do we put the remmina systray menu, and which API do we use for it ?
14 Q2. Does this place also allow the user to raise a hidden window via gtk_window_present() ?
18 * [freedesktop.org system tray spec](http://www.freedesktop.org/wiki/Specifications/systemtray-spec/)
19 * [Libunity source code](http://bazaar.launchpad.net/~unity-team/libunity/trunk/files), written in vala.
21 # The desktop environments
24 In Ubuntu's Unity, we currently do not use GtkStatusIcon, but libappindicator. This almost works, but when the remmina windows are not on the top, we are unable to present its windows to users. This is explained in [issue #542](https://github.com/FreeRDP/Remmina/issues/542) and it's a problem of the window manager which prevents gtk_window_present() to stealing focus to other applications.
25 We could use DBusMenu and the [Launcher API](https://wiki.ubuntu.com/Unity/LauncherAPI) to move all the current remmina systray menu into Unity Launcher icon as **dynamic quicklist entries**.
26 Compatibility with gtk_window_present() must be tested.
29 Some functions of the [Shell](https://developer.gnome.org/shell/stable/) for ShellTrayIcon object should help for the icon (but no menu support ???). For correctly placing a menu, we can take a look to [Gnome Shell Extension Appindicator source code](https://github.com/rgcjonas/gnome-shell-extension-appindicator).
31 Read [this page](https://wiki.gnome.org/Design/Whiteboards/StatusIcons) which contains a possible plan for GtkStatusIcon under Gnome Shell.
33 In Gnome Shell, Status Icons (GtkStatusIcon) were hidden into the Message Tray at the bottom of the screen.
34 See https://help.gnome.org/misc/release-notes/3.6/users-message-tray.html.en
35 The Message Tray has been removed with Gnome Shell 3.16: https://help.gnome.org/misc/release-notes/3.16/ and it seems that a new drawer has been added to the bottom left of the screen to host all application status icons. Unfortunately I'm currently unable to find official changelog/documentation for this drawer.
38 Currently Remmina detects Gnome Shell and, if detected, remmina will quit when there are no visible windows on the screen. We did this because older Gnome Shells hides all deprecated GtkStatusIcons in a hidden place below the screen, and the user is unable to undestand when remmina is running.
39 Starting with [Gnome Shell 3.16](http://www.webupd8.org/2015/03/gnome-316-released-with-new.html) a new drawer has been introduced, which can give the user visual feedback of the GtkStatusIcon presence.
43 In KDE [KStatusNotifierItem](http://api.kde.org/frameworks-api/frameworks5-apidocs/knotifications/html/classKStatusNotifierItem.html)
47 In Plasma 5 they have removed completely the support of the xembed protocol, but you can run XEmbed SNI Proxy and work around it.
49 The goal of this project is to make xembed system trays available in Plasma:
51 https://github.com/KDE/plasma-workspace/tree/master/xembed-sni-proxy [-]
67 ### EXTERNAL SOURCES ###
69 * [Proper implementation of system tray icons via libappindicator/StatusNotifierItem](https://code.google.com/p/chromium/issues/detail?id=419673)
70 * [Updated Tray to use libappindicator in Linux](https://github.com/nwjs/nw.js/pull/2327) Discussion that propose the same Google Chrome fix.
