Plasma Mobile running on LG Nexus 5 (hammerhead)
|Graphics stack||KWin on Wayland|
A mobile variant of the KDE Plasma user interface, optimized for touchscreen.
It works on most devices with a working display, both with hardware acceleration and software rendering. There is however an issue making it unable to run on armhf devices without hardware acceleration.
Do note that this interface is unbearably slow without hardware acceleration and isn't recommended at all without it.
pmbootstrap init and choose
plasma-mobile in the interface section. If you already have postmarketOS installed, you can install Plasma Mobile by running
# apk add postmarketos-ui-plasma-mobile. Make sure you uninstall any other UI before you do this.
After installation, the shell will automatically launch upon boot using LightDM. If it doesn't, have a look at
$ logread | grep plasma-mobile and
For the official KDE instructions on running Plasma Mobile, see their website.
Plasma can also be used if your device doesn't support hardware acceleration (if it's a non-armhf device) yet by using software rendering. Please note that the interface will be slow, and it might not be usable for the average user.
Software rendering will be enabled automatically if no hardware acceleration is detected, just make sure
mesa-dri-swrast is installed.
You can read the log output with
logread -f. Anything related to Plasma and KDE will have a
Logging isn't verbose
One needs to enable debug logging for certain components in
~/.config/QtProject/qtlogging.ini. Without that, you barely see any log output. We ship such a qtlogging.ini file in
postmarketos-ui-plasma-mobile because Plasma Mobile is relatively new and we want to be able to debug it properly.
If the file did not get installed for you, please double check if it is there and report in 1038.
KWin doesn't work
Please follow these instructions for debugging.
Follow the Display guide to change and fix display related issues.