SHIFT is an open source shell built on KDE Plasma Mobile, designed to adapt fluidly to your computing needs across devices
Find a file
Devin Lin e66d88a754 initialstart: Introduce InitialStartModule as top level item for modules
Currently modules are initialized as QQuickItems. In order to be able to
add custom properties for modules to set in the future, introduce
InitialStartModule as the top-level QML object for modules to
initialize.

Currently only two properties are implemented: `available` for whether
to show the module in the wizard, and `contentItem` for the visual
module item.
2024-11-06 22:07:50 -08:00
.reuse Add dep5 file for setting license of json files 2022-07-21 19:30:11 +00:00
bin SVN_SILENT made messages (.desktop file) - always resolve ours 2024-04-25 01:16:26 +00:00
components actiondrawer: Cleanup and simplify 2024-11-05 03:42:25 +00:00
containments homescreens/folio: FavouritesBar: Icon position animation bugfix 2024-11-07 05:17:57 +00:00
envmanager disable electric border highlighting by default in envmanager 2024-11-05 09:03:45 +01:00
initialstart initialstart: Introduce InitialStartModule as top level item for modules 2024-11-06 22:07:50 -08:00
kcms kcms/time: Fix layout of time dialog and port date dialog to DatePopup 2024-11-04 20:34:57 -08:00
kded Drop unused link libraries 2024-10-31 08:41:01 +00:00
kwin reintroduce maximizing task on activating it in switcher 2024-10-21 11:53:36 +02:00
layout-templates SVN_SILENT made messages (.desktop file) - always resolve ours 2024-10-10 01:23:11 +00:00
LICENSES Remove trailing whitespace 2024-07-26 23:47:44 -04:00
lookandfeel SVN_SILENT made messages (.desktop file) - always resolve ours 2024-09-25 01:24:12 +00:00
po GIT_SILENT Sync po/docbooks with svn 2024-11-07 01:34:32 +00:00
quicksettings SVN_SILENT made messages (.desktop file) - always resolve ours 2024-10-10 01:23:11 +00:00
screenshots Remove trailing whitespace 2024-07-26 23:47:44 -04:00
shell [mobileshell]: apply scale factor to status bar 2024-10-25 17:53:25 +00:00
tests actiondrawer: Share components between portrait and landscape 2024-10-31 15:27:00 +00:00
.git-blame-ignore-revs REUSE compliance, add check to CI, drop unused components 2021-12-23 16:02:41 +00:00
.gitignore Remove trailing whitespace 2024-07-26 23:47:44 -04:00
.gitlab-ci.yml ci: add Alpine/musl job 2024-08-18 10:02:32 +00:00
.kde-ci.yml Adapt to plasma-framework being renamed to libplasma 2023-11-25 15:43:49 +01:00
CMakeLists.txt VolumeOSD: Improve design, and prevent touch events from being taken from outside the osd 2024-10-25 15:52:49 +00: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
plasma-mobile.service systemd: add service file to start Plasma 2024-09-09 15:50:48 +00:00
plasma-mobile.service.license systemd: add service file to start Plasma 2024-09-09 15:50:48 +00:00
README.md Remove trailing whitespace 2024-07-26 23:47:44 -04: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
  • 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