# Wayland Support {#wayland-support}


Notes on running Gauzy desktop applications on Linux with the Wayland display server.


## Status {#status}


| Feature            | X11 |         Wayland         |
| ------------------ | :-: | :---------------------: |
| Application window | ✅  |           ✅            |
| System tray        | ✅  |       ⚠️ Partial        |
| Screenshots        | ✅  | ⚠️ Requires permissions |
| Global shortcuts   | ✅  |       ❌ Limited        |


## Screenshot Capture on Wayland {#screenshot-capture-on-wayland}


Wayland's security model restricts screen capture. The Desktop Timer may require:

1. **PipeWire** — modern screen capture API
2. **xdg-desktop-portal** — portal-based screen sharing
3. **XWayland fallback** — running under X11 compatibility


### Enabling PipeWire Screenshots {#enabling-pipewire-screenshots}


```bash
# 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 {#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 {#launch-flags}


For best Wayland compatibility:

```bash
# Force Wayland
GDK_BACKEND=wayland ./GauzyDesktopTimer.AppImage

# Force X11 fallback
GDK_BACKEND=x11 ./GauzyDesktopTimer.AppImage
```


## Related Pages {#related-pages}


- [Desktop Overview](https://sourcey-gauzy.pages.dev/desktop/desktop-overview/index.md)
- [Troubleshooting](https://sourcey-gauzy.pages.dev/desktop/troubleshooting/index.md) — common issues