mirror of
https://invent.kde.org/marcoa/shift-shell.git
synced 2026-04-26 14:23:09 +00:00
SHIFT is an open source shell built on KDE Plasma Mobile, designed to adapt fluidly to your computing needs across devices
plasma-desktop added support for a unsavedChanges property in applet configuration pages to inform the dialog that the present state is modifed from the saved state in cases where the automatic tracking of cfg_ properties does not work. This is intended to replace most uses of the configurationChanged signal, which does not allow communicating that the previous state has been restored and saving is no longer necessary. plasma-mobile automatically saves changes, so does not need to do special handling here, but it does need to track changes in this property to work correctly with applets that have switched to this method. This change adds a handler for changes to this property similar to the existing handler for the configurationChanged signal. |
||
|---|---|---|
| .reuse | ||
| bin | ||
| components | ||
| containments | ||
| envmanager | ||
| initialstart | ||
| kcms | ||
| kded | ||
| kwin | ||
| layout-templates | ||
| LICENSES | ||
| lookandfeel | ||
| po | ||
| quicksettings | ||
| screenshots | ||
| shell | ||
| tests | ||
| .git-blame-ignore-revs | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| .kde-ci.yml | ||
| CMakeLists.txt | ||
| logo.png | ||
| logo.png.license | ||
| plasma-mobile.service | ||
| plasma-mobile.service.license | ||
| README.md | ||
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-countflag for the number of displays - Specify
--widthand--heightfor 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