SHIFT is an open source shell built on KDE Plasma Mobile, designed to adapt fluidly to your computing needs across devices
Find a file
Marco Allegretti 523c3a6728 Support rootless KAuth install for local development
Add PLASMA_MOBILE_LOCAL_KAUTH_INSTALL CMake option to redirect KAuth
helper executables, D-Bus service files, and polkit policy files into
CMAKE_INSTALL_PREFIX instead of hardcoded /usr paths.

Guard KF6Auth find_package calls in helper subdirectories with
if(NOT TARGET KF6::AuthCore) to avoid re-running find_package after
the top-level override, which would revert generated service Exec
paths back to /usr/libexec/kf6/kauth.
2026-04-08 19:06:55 +02:00
.reuse Add dep5 file for setting license of json files 2022-07-21 19:30:11 +00:00
.well-known Add license 2025-07-30 20:55:48 -03:00
bin Switch from maliit-keyboard to plasma-keyboard 2025-12-04 10:06:21 -05:00
components Support rootless KAuth install for local development 2026-04-08 19:06:55 +02:00
containments SVN_SILENT made messages (.desktop file) - always resolve ours 2026-03-15 01:41:15 +00:00
devices devices: add Fairphone 5 2026-03-02 20:55:35 -05:00
envmanager envmanager: Add KDE Connect SMS to applications blocklist 2026-02-16 21:50:15 -05:00
initialstart SVN_SILENT made messages (.desktop file) - always resolve ours 2026-04-06 01:38:32 +00:00
kcms SVN_SILENT made messages (.desktop file) - always resolve ours 2026-03-31 01:41:23 +00:00
kded Install logging categories 2026-04-06 13:39:00 +02:00
kwin SVN_SILENT made messages (.desktop file) - always resolve ours 2026-03-15 01:41:15 +00:00
layout-templates SVN_SILENT made messages (.desktop file) - always resolve ours 2026-03-15 01:41:15 +00:00
LICENSES kcm: split navbar to own kcm, add gesture tutorial 2025-09-05 12:44:32 +02:00
lookandfeel Remove kirigami version in imports 2026-03-06 22:08:07 -05:00
po GIT_SILENT Sync po/docbooks with svn 2026-04-05 01:49:11 +00:00
quicksettings Support rootless KAuth install for local development 2026-04-08 19:06:55 +02:00
screenshots Remove trailing whitespace 2024-07-26 23:47:44 -04:00
shell SVN_SILENT made messages (.desktop file) - always resolve ours 2026-03-15 01:41:15 +00:00
tests Remove kirigami version in imports 2026-03-06 22:08:07 -05:00
.git-blame-ignore-revs REUSE compliance, add check to CI, drop unused components 2021-12-23 16:02:41 +00:00
.gitignore Improvements to initialstart + 1 more 2024-11-10 06:35:06 +00:00
.gitlab-ci.yml Ensure i18n is used with double quotes and add CI check 2025-08-11 18:19:41 -04:00
.kde-ci.yml Enable qmllint in CI 2025-08-22 13:42:42 +02:00
CMakeLists.txt Support rootless KAuth install for local development 2026-04-08 19:06:55 +02:00
logo.png Add repository icon 2021-12-23 22:37:54 +00:00
logo.png.license Fix license header 2021-12-23 22:41:04 +00:00
org.kde.plasma.mobileshell.metainfo.xml GIT_SILENT made messages (after extraction) 2026-03-15 00:47:14 +00:00
plasma-mobile.service systemd: default kde-plasma service to tty1 2025-12-13 20:17:47 -05:00
plasma-mobile.service.license systemd: add service file to start Plasma 2024-09-09 15:50:48 +00:00
README.md readme: Fix link 2025-11-06 07:55:15 -05:00

Plasma Mobile

This repository contains shell components for Plasma Mobile.

Reporting 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
  • feedbackd (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

Device specific configuration

See /devices/README.md for more details on setting device specific configuration (ex. notches, screen curves).