Plasma Mobile

This repository contains shell components for Plasma Mobile.

Project page: plasma-mobile.org
Repository: invent.kde.org/plasma/plasma-mobile
Documentation: invent.kde.org/plasma/plasma-mobile/-/wikis/home
Development channel: matrix.to/#/#plasmamobile:matrix.org

Reporting issues

How to report issues: invent.kde.org/plasma/plasma-mobile/-/wikis/Issue-Tracking
Shell issue tracker: invent.kde.org/plasma/plasma-mobile/-/issues
General issue tracker: https://invent.kde.org/teams/plasma-mobile/issues/-/issues

Locations

components/mobileshell - private shell component library (API not guaranteed to be stable!)
containments - shell panels (homescreens, status bar, task panel)
kcms - settings module
look-and-feel - Plasma look-and-feel packages (ex. lockscreen, logout, etc.)
shell - Plasma shell package, provides implementations for applet and containment configuration dialogs
quicksettings - quick settings packages for the action drawer
tests - small runnable snippets that can be used to test parts of the shell without loading all of Plasma

Test on a development machine

See the documentation page for more details.

It is recommended to use kdesrc-build to build this from source. See this page in order to set it up.

Dependencies:

KDE Frameworks 6 setup (plasma-framework and its dependencies)
plasma-nano
plasma-workspace
plasma-nm
plasma-pa
bluez-qt
Milou (for search)
Kirigami
Kirigami Addons
feedbackd (optional: for vibrations)

To start the shell in a window, run:

QT_QPA_PLATFORM=wayland dbus-run-session kwin_wayland --xwayland "plasmashell -p org.kde.plasma.mobileshell"

Useful options:

Specify the --output-count flag for the number of displays
Specify --width and --height for the window size

QT_QPA_PLATFORM=wayland dbus-run-session kwin_wayland --xwayland "plasmashell -p org.kde.plasma.mobileshell" --output-count 2 --width 360 --height 720

Device specific configuration

See devices/README.md for more details on setting device specific configuration (ex. notches, screen curves).