Wayland Support
Notes on running Gauzy desktop applications on Linux with the Wayland display server.
Statusโ
| Feature | X11 | Wayland |
|---|---|---|
| Application window | โ | โ |
| System tray | โ | โ ๏ธ Partial |
| Screenshots | โ | โ ๏ธ Requires permissions |
| Global shortcuts | โ | โ Limited |
Screenshot Capture on Waylandโ
Wayland's security model restricts screen capture. The Desktop Timer may require:
- PipeWire โ modern screen capture API
- xdg-desktop-portal โ portal-based screen sharing
- XWayland fallback โ running under X11 compatibility
Enabling PipeWire Screenshotsโ
# Install PipeWire and portal
sudo apt install pipewire xdg-desktop-portal-gtk
# Run Electron with Wayland flags
electron --ozone-platform=wayland --enable-features=WaylandWindowDecorations
System Trayโ
Some Wayland compositors have limited tray support:
| Compositor | Tray Support |
|---|---|
| GNOME (Mutter) | Via extension |
| KDE Plasma | โ Native |
| Sway | โ Via waybar |
| Hyprland | โ Via waybar |
Launch Flagsโ
For best Wayland compatibility:
# Force Wayland
GDK_BACKEND=wayland ./GauzyDesktopTimer.AppImage
# Force X11 fallback
GDK_BACKEND=x11 ./GauzyDesktopTimer.AppImage
Related Pagesโ
- Desktop Overview
- Troubleshooting โ common issues