On this page, we're collecting tips and tricks to make Plasma work on Wayland:

Build instructions

We recommend following this guide to install the Wayland stack, including the QtWayland module

http://qt-project.org/wiki/QtWayland

Generic, but more detailed build instructions for Wayland / Weston, including underlying stack can be found at: http://wayland.freedesktop.org/building.html

Create a wl-env script somewhere in your $PATH, looking like this (adjust WLD to your wayland installation path):

WLD=/home/sebas/kf5/wayland/install
LD_LIBRARY_PATH=$WLD/lib
PKG_CONFIG_PATH=$WLD/lib/pkgconfig/:$WLD/share/pkgconfig/
ACLOCAL="aclocal -I $WLD/share/aclocal"
export YACC=bison

export WLD LD_LIBRARY_PATH PKG_CONFIG_PATH ACLOCAL YACC

if test -z "${XDG_RUNTIME_DIR}"; then
    export XDG_RUNTIME_DIR=/tmp/${UID}-runtime-dir
    if ! test -d "${XDG_RUNTIME_DIR}"; then
        mkdir "${XDG_RUNTIME_DIR}"
        chmod 0700 "${XDG_RUNTIME_DIR}"
    fi
fi

Running KF5 applications under Wayland

Inside an existing X session

weston

starts a new window under your X server with Weston running inside it.

Standalone

From a hard console / virtual terminal:

kf5-env
wl-env
export $(dbus-launch)
weston-launch
kwrite -platform wayland

kf5-env is a script setting up the locations, such as QTDIR, plugin path, etc. for your kf5.

Issues

The following contains a list of issues found when trying to run Plasma or KF5-based software in general under Wayland.

kdeinit5 exits due to missing DISPLAY
kded5 just hangs there when started
Oxygen style works in windowed mode, falls back to Fusion in standalone
File open dialog unable to reach klauncher
After resizing a window, it's not immediately repainted over the new covering area