waywallen/waywallen-display
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
43 commits 1 branch 0 tags 821 KiB
  • C 74.8%
  • C++ 12.9%
  • JavaScript 5.9%
  • CMake 4%
  • QML 2.4%
Find a file
Exact
hypengw be70fe8748 gnome draft
2026-05-05 12:02:40 +00:00
.github/workflows ci: switch release-kde-zip workflow to cpack package target 2026-05-02 17:07:57 +00:00
examples signal release_syncobj on the EGL consumer path 2026-05-01 07:51:51 +00:00
extensions gnome draft 2026-05-05 12:02:40 +00:00
include protocol v4: add instance_id; KDE generates UUID4 per containment, daemon keys settings by it 2026-05-02 17:47:48 +00:00
plugins gnome draft 2026-05-05 12:02:40 +00:00
src regen ww_proto bindings for reserved mouse_event 2026-05-02 18:11:34 +00:00
tests align consumer_caps with daemon negotiation: LINEAR_ONLY + DEVICE_LOCAL 2026-04-30 22:45:57 +08:00
.gitignore WaywallenSurfaceEmbed 2026-04-26 12:26:37 +08:00
BUILD.md refocus README on features; move flow + protocol detail to BUILD.md 2026-05-02 16:56:03 +00:00
CMakeLists.txt gnome draft 2026-05-05 12:02:40 +00:00
glibc-2.17.h WaywallenSurfaceEmbed 2026-04-26 12:26:37 +08:00
LICENSE docs: add MIT license 2026-04-11 12:17:03 +08:00
README.CN.md bump version to 0.1.1 2026-05-02 16:58:27 +00:00
README.md bump version to 0.1.1 2026-05-02 16:58:27 +00:00

README.md

waywallen-display

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.

What's implemented

  • Protocol client — C library that speaks waywallen-display v1 to the daemon and receives DMA-BUF frames plus acquire/release sync fences.
  • Qt 6 QML plugin (Waywallen.Display) — drop-in WaywallenSurface item for Qt Quick scenes.
  • KDE Plasma wallpaper extension — Plasma 6 kpackage built on the QML plugin.

GNOME Shell extension is on the roadmap.

Install

Prebuilt artifacts are published on the GitHub releases page.

KDE Plasma extension

Download waywallen-kde-<version>-<arch>.zip from the latest release, then:

kpackagetool6 --type Plasma/Wallpaper -i waywallen-kde-<version>-<arch>.zip
# -u to upgrade, -r to remove

Tip

On KDE Plasma, restart the shell so the freshly installed QML plugin is picked up:

systemctl --user restart plasma-plasmashell.service

Extensions

Extension Notes
kde Plasma 6 wallpaper plugin

Building from source

See BUILD.md.