https://github.com/KDE/plasma-mobile

Plasma shell for mobile devices
https://github.com/KDE/plasma-mobile

Last synced: 6 days ago
JSON representation

Plasma shell for mobile devices

• Host: GitHub
• URL: https://github.com/KDE/plasma-mobile
• Owner: KDE
• Created: 2015-09-18T12:44:14.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2024-09-18T03:11:45.000Z (about 2 months ago)
• Last Synced: 2024-09-18T23:50:12.389Z (about 2 months ago)
• Language: QML
• Homepage: https://invent.kde.org/plasma/plasma-mobile
• Size: 65 MB
• Stars: 159
• Watchers: 19
• Forks: 16
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSES/Apache-2.0.txt

Awesome Lists containing this project

README

        


# 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

```

---