# Plasma Mobile This repository contains shell components for Plasma Mobile. * Project page: [plasma-mobile.org](https://plasma-mobile.org) * Repository: [invent.kde.org/plasma/plasma-mobile](https://invent.kde.org/plasma/plasma-mobile) * Documentation: [invent.kde.org/plasma/plasma-mobile/-/wikis/home](https://invent.kde.org/plasma/plasma-mobile/-/wikis/home) * Development channel: [matrix.to/#/#plasmamobile:matrix.org](https://matrix.to/#/#plasmamobile:matrix.org) ### Reporting issues * How to report issues: [invent.kde.org/plasma/plasma-mobile/-/wikis/Issue-Tracking](https://invent.kde.org/plasma/plasma-mobile/-/wikis/Issue-Tracking) * Shell issue tracker: [invent.kde.org/plasma/plasma-mobile/-/issues](https://invent.kde.org/plasma/plasma-mobile/-/issues) * General issue tracker: [https://invent.kde.org/teams/plasma-mobile/issues/-/issues](https://invent.kde.org/teams/plasma-mobile/issues/-/issues) ### Locations * [components/mobileshell](components/mobileshell) - private shell component library (API not guaranteed to be stable!) * [containments](containments) - shell panels (homescreens, status bar, task panel) * [kcms](kcms) - settings module * [look-and-feel](look-and-feel/contents) - Plasma look-and-feel packages (ex. lockscreen, logout, etc.) * [shell](shell) - Plasma shell package, provides implementations for applet and containment configuration dialogs * [quicksettings](quicksettings) - quick settings packages for the action drawer * [tests](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](https://invent.kde.org/plasma/plasma-mobile/-/wikis/Building-and-Testing-Locally) for more details. It is recommended to use `kdesrc-build` to build this from source. See [this page](https://community.kde.org/Get_Involved/development) 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 ``` ---