Platform support

Matrix

Platform / DE	Theme	Wallpaper	Notification	WakeLock	Tray	Media	Session
Windows 10 / 11	✅	✅	✅ ¹	✅	✅	✅	✅
GNOME 42+	✅	✅	✅	✅	✅	✅	✅
KDE Plasma 5 / 6	✅	✅	✅	✅	✅	✅	✅
XFCE	✅	✅	✅	✅	⚠️	✅	✅
Hyprland	⚠️	✅	⚠️	⚠️	✅	✅	✅
Sway	⚠️	✅	⚠️	⚠️	✅	✅	✅
Generic X11	⚠️	✅	⚠️	⚠️	✅	✅	✅

✅ verified against the real backend · ⚠️ best-effort fallback.

Tier used per feature

Feature	Windows	GNOME	KDE	Hyprland / Sway	Generic X11
Theme	Registry	Portal `Settings`	`kreadconfig6` / `5`	GSettings	GSettings
Wallpaper	`SystemParametersInfoW`	`gsettings` CLI	D-Bus `plasmashell`	`hyprpaper` → `swww`	`feh` → `nitrogen`
Notification	WinRT toast	`org.freedesktop.Notifications`	`org.freedesktop.Notifications`	`org.freedesktop.Notifications`	`org.freedesktop.Notifications`
WakeLock	`SetThreadExecutionState`	ScreenSaver `Inhibit`	ScreenSaver `Inhibit`	ScreenSaver `Inhibit`	ScreenSaver `Inhibit`
Tray	`Shell_NotifyIconW`	SNI via watcher	SNI via watcher	SNI via watcher	SNI via watcher
Media	SMTC	MPRIS v2	MPRIS v2	MPRIS v2	MPRIS v2
Session	Win32	logind / ScreenSaver	logind / ScreenSaver	logind	logind / `loginctl`

What ⚠️ means in practice

The exact answer is always available at runtime through capabilities() / support_level() — never assume from this table.

Entry	What the fallback does	Reported as
Theme on Hyprland / Sway / X11	No system-wide colour scheme; reads GSettings if a GTK app has written a value	the read returns `Theme::Unknown`
Notifications on tilers / X11	`org.freedesktop.Notifications` works, but actions and images depend on the installed daemon	actions are rendered only if the daemon supports them
WakeLock on tilers / X11	Calls `org.freedesktop.ScreenSaver.Inhibit`; there is no CLI fallback, so an absent service fails the call	`UdaError` (connection failure)
Tray on XFCE	SNI works through the AppIndicator-compatible watcher, but no native double-click event	`SupportLevel::None` for `DoubleClick`

Reporting from a host application

use uda_core::capability::SupportLevel;
use uda_core::tray::{TrayFeature, TrayManager};

let manager = uda_platform_linux::LinuxTrayManager::new();
let level = manager.support_level(TrayFeature::DoubleClick);

match level {
    SupportLevel::Full => { /* draw the double-click action */ }
    SupportLevel::Partial => { warn!("double click is degraded on this backend") }
    SupportLevel::None => { /* hide it */ }
}

From a C host the same information is available through uda_session_capabilities and the module capabilities() functions.

Not yet covered (Phase 3)

Global shortcuts, the multi-format clipboard with change listening, audio endpoint routing and display brightness are in progress — see plans/phase3_plan.md.

See also

Capability and fallback — how the tier chain works
Troubleshooting — what to do when a feature reports Unsupported

See the Windows notification limitations. ↩