Readme.md

## XEmbed TrayManager1 Proxy

The goal of this project is to make xembed system trays available in DDE Treeland (wayland) session.

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

> [!NOTE]
> The initial commit was a minimal KF6 dependency version of KDE's `xembed-sni-proxy` project, extracted from `plasma-workspace`.
> Currently this project is a standalone project that provides Xembed tray information on TrayManager1 D-Bus, so `dde-tray-loader` could consume it and provide Xembed tray icons.
> This project will be integrated into `dde-tray-loader` project.

This tool can be used on a Wayland session with `wayland` QPA, `xcb` QPA can also be used but it's not mandatory, but either way it's required to have a X connection (via X11 or Xwayland).

## Build instructions

```shell
$ cmake -Bbuild .
$ cmake --build build
```

After building, run `xembed-traymanager-proxy`.

[1] http://standards.freedesktop.org/systemtray-spec/systemtray-spec-latest.html
[2] http://www.freedesktop.org/wiki/Specifications/StatusNotifierItem/
readme 2025-12-19 10:28:57 +08:00			`## XEmbed TrayManager1 Proxy`
init 2025-12-18 16:41:37 +08:00
readme 2025-12-19 10:28:57 +08:00			`The goal of this project is to make xembed system trays available in DDE Treeland (wayland) session.`
init 2025-12-18 16:41:37 +08:00
readme 2025-12-19 10:28:57 +08:00			`This is to allow legacy apps (xchat, pidgin, tuxguitar) etc. system trays[1] available in DDE Treeland which only supports StatusNotifierItem [2].`
init 2025-12-18 16:41:37 +08:00
readme 2025-12-19 10:28:57 +08:00			`> [!NOTE]`
			> The initial commit was a minimal KF6 dependency version of KDE's `xembed-sni-proxy` project, extracted from `plasma-workspace`.
			> Currently this project is a standalone project that provides Xembed tray information on TrayManager1 D-Bus, so `dde-tray-loader` could consume it and provide Xembed tray icons.
			> This project will be integrated into `dde-tray-loader` project.
init 2025-12-18 16:41:37 +08:00
no longer rely on ecm_qt_declare_logging_category 2025-12-25 15:13:46 +08:00			This tool can be used on a Wayland session with `wayland` QPA, `xcb` QPA can also be used but it's not mandatory, but either way it's required to have a X connection (via X11 or Xwayland).

readme 2025-12-19 10:28:57 +08:00			`## Build instructions`
init 2025-12-18 16:41:37 +08:00
readme 2025-12-19 10:28:57 +08:00			```shell
			`$ cmake -Bbuild .`
			`$ cmake --build build`
			```
init 2025-12-18 16:41:37 +08:00
readme 2025-12-19 10:28:57 +08:00			After building, run `xembed-traymanager-proxy`.
init 2025-12-18 16:41:37 +08:00
			`[1] http://standards.freedesktop.org/systemtray-spec/systemtray-spec-latest.html`
			`[2] http://www.freedesktop.org/wiki/Specifications/StatusNotifierItem/`