Desktop integration for the waywallen wallpaper daemon — lets KDE Plasma,
GNOME Shell, and other Linux desktop shells display waywallen wallpaper
output as a regular surface, with zero-copy GPU sharing via DMA-BUF.
- Protocol client — C library that speaks
waywallen-displayv1 to the daemon and receives DMA-BUF frames plus acquire/release sync fences. - Qt 6 QML plugin (
Waywallen.Display) — drop-inWaywallenSurfaceitem for Qt Quick scenes. - gobject plugin — Helper for building
GdkTexturethroughwaywallen-display. - KDE Plasma wallpaper extension — Plasma 6 kpackage built on the QML plugin.
- GNOME Shell extension — Shell 48+ extension built on gobject plugin.
- Wayland layer-shell client — standalone
wallpaper client for compositors that expose
zwlr_layer_shell_v1.
Prebuilt artifacts are published on the GitHub releases page.
Download waywallen-kde-<version>-<arch>-embed.zip from the latest release, then:
kpackagetool6 --type Plasma/Wallpaper -i waywallen-kde-<version>-<arch>-embed.zip
# -u to upgrade, -r to removeTip
On KDE Plasma, restart the shell so the freshly installed QML plugin is picked up:
systemctl --user restart plasma-plasmashell.serviceTip
On X11(like steamdeck), plasmashell needs the EGL XCB backend, Add a systemd user drop-in at
~/.config/systemd/user/plasma-plasmashell.service.d/override.conf:
[Service]
Environment=QT_XCB_GL_INTEGRATION=xcb_eglThen reload and restart:
systemctl --user daemon-reload
systemctl --user restart plasma-plasmashell.serviceGNOME Shell on Wayland (tested on Shell 50). Download waywallen-gnome-<version>-<arch>.zip from the
latest release, then:
gnome-extensions install --force waywallen-gnome-<version>-<arch>.zip
gnome-extensions enable org.waywallen.gnome@waywallen.ioLog back out and in to load it.
For Wayland compositors that expose zwlr_layer_shell_v1 (for example
Hyprland, Sway, Niri), download
waywallen-layer-shell-<version>-<arch>.tar.gz from the latest release, then:
tar -xzf waywallen-layer-shell-<version>-<arch>.tar.gz
install -Dm755 waywallen-layer-shell-<version>-<arch>/waywallen-layer-shell ~/.local/bin/waywallen-layer-shell
cp -r waywallen-layer-shell-<version>-<arch>/share ~/.local/The share directory contains the translation catalogs. Keep it when moving
the binary if localized CLI output is required.
waywallen-layer-shell
# optional:
waywallen-layer-shell --socket "$XDG_RUNTIME_DIR/waywallen/display.sock"Note
The appimage version of waywallen has already embed waywallen-layer-shell.
And waywallen will manage it.
| Extension | Notes |
|---|---|
| kde | Plasma 6 wallpaper plugin |
| gnome | GNOME Shell 48–50 extension (Wayland) |
| layer-shell | Client for wayland zwlr_layer_shell_v1 |
See BUILD.md.