marcoallegretti/shift-shell
1
0
Fork 0
mirror of https://invent.kde.org/marcoa/shift-shell.git synced 2026-04-26 14:23:09 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
SHIFT is an open source shell built on KDE Plasma Mobile, designed to adapt fluidly to your computing needs across devices
3958 commits 1 branch 0 tags 40 MiB
QML 54.8%
C++ 40.9%
CMake 3.1%
Shell 0.5%
JavaScript 0.4%
Other 0.3%
Find a file
Marco Allegretti e12e6b3a66 Add system tray to status bar in convergence mode 
Reintroduce StatusNotifierModel-based system tray icons, gated on
convergenceModeEnabled. Desktop apps (KDE Connect, nm-applet, etc.)
expose tray icons that were removed in 1914e9be as unusable on
phone screens.

The status bar wrapper is raised above the ActionDrawerOpenSurface
so tray icon MouseAreas receive click events while non-interactive
areas still fall through to the swipe handler.

TaskWidget.qml supports left-click (Activate), right-click
(ContextMenu), hover tooltip, and hides Passive/ApplicationStatus
items. The lockscreen SIGABRT guard (disableSystemTray) is restored
on the action drawer's StatusBar instance.
2026-04-08 20:12:16 +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 Add system tray to status bar in convergence mode 2026-04-08 20:12:16 +02:00
containments Add system tray to status bar in convergence mode 2026-04-08 20:12:16 +02:00
devices devices: add Fairphone 5 2026-03-02 20:55:35 -05:00
envmanager Add task strip and Overview to navigation panel 2026-04-08 19:07:37 +02: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

README.md

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).