KDE/plasma-mobile

Plasma shell for mobile devices

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
• hfd-service (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

---