plasma-workspace/xembed-sni-proxy at master · ayaz345/plasma-workspace

Name		Name	Last commit message	Last commit date
parent directory ..
CMakeLists.txt		CMakeLists.txt
Readme.md		Readme.md
fdoselectionmanager.cpp		fdoselectionmanager.cpp
fdoselectionmanager.h		fdoselectionmanager.h
main.cpp		main.cpp
org.kde.StatusNotifierItem.xml		org.kde.StatusNotifierItem.xml
org.kde.StatusNotifierWatcher.xml		org.kde.StatusNotifierWatcher.xml
plasma-xembedsniproxy.service.in		plasma-xembedsniproxy.service.in
snidbus.cpp		snidbus.cpp
snidbus.h		snidbus.h
sniproxy.cpp		sniproxy.cpp
sniproxy.h		sniproxy.h
xcbutils.h		xcbutils.h
xembedsniproxy.desktop		xembedsniproxy.desktop
xtestsender.cpp		xtestsender.cpp
xtestsender.h		xtestsender.h

Readme.md

##XEmbed SNI Proxy

The goal of this project is to make xembed system trays available in Plasma.

This is to allow legacy apps (xchat, pidgin, tuxguitar) etc. system trays[1] available in Plasma which only supports StatusNotifierItem [2].

Ideally we also want this to work in an xwayland session, making X system tray icons available even when plasmashell only has a wayland connection.

This project should be portable onto all other DEs that speak SNI.

##How it works (in theory)

We register a window as a system tray container
We render embedded windows composited offscreen
We render contents into an image and send this over DBus via the SNI protocol
XDamage events trigger a repaint
Activate and context menu events are replyed via X send event into the embedded container as left and right clicks

There are a few extra hacks in the real code to deal with some toolkits being awkward.

##Build instructions

cmake .
make
sudo make install

After building, run xembedsniproxy.