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
Having a global set margins and orientation (that were calculated from the panel containment) caused a lot of issues with the way bindings were evaluated across panels, and with high coupling. Now use properties from within containments to determine shell margins instead, which removes the dependency on other containments for measurements. This allows us to get rid of TaskPanelControls as well! Fixes: https://invent.kde.org/teams/plasma-mobile/issues/-/issues/198 |
||
|---|---|---|
| .reuse | ||
| bin | ||
| components | ||
| containments | ||
| kcms | ||
| LICENSES | ||
| look-and-feel | ||
| po | ||
| quicksettings | ||
| screenshots | ||
| shell | ||
| tests | ||
| .git-blame-ignore-revs | ||
| .gitignore | ||
| .gitlab-ci.yml | ||
| .kde-ci.yml | ||
| CMakeLists.txt | ||
| logo.png | ||
| logo.png.license | ||
| plasma_phone_components.notifyrc | ||
| 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 5 setup (plasma-framework and its dependencies)
- Plasma Nano
- Kirigami
- Kirigami Addons
To start the phone homescreen in a window, run:
QT_QPA_PLATFORM=wayland dbus-run-session kwin_wayland --xwayland "plasmashell -p org.kde.plasma.phoneshell"