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
3789 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
Devin Lin 839d5e2bff panels: Add support for defining device specific panel tweaks 
This adds support for specifying options needed to deal with phone
display panel pecularities (ex. screen curves, notches, punch holes)

This is implemented as settings in ~/.config/plasmamobilerc, which can
set panel heights, paddings, and center spacings to duck display
cutouts. The pixel values are scaling independent, and so are not
affected when the display scaling is changed.

This is then exposed over DBus, so that components from outside of
plasmashell (ex. KWin) can access it easily without needing to connect to
kscreen themselves. Each screen is exposed as a single object.

Currently support is only added in the status bar and the navigation
panel.

Currently all screens have the settings applied. In the future, we may
want to limit this just to the internal screen (?)

---

This also adds a "devices" folder (in `devices/configs`) where per-device configs can be set.

This is installed to `/usr/share/plasma-mobile-device-configs`.
In `plasmamobilerc` (installed to `/etc/xdg/plasmamobilerc`, or
`~/.config/plasmamobilerc`), envmanager will read:

```toml
[Device]
device=oneplus-enchilada
```

for the device config to use and write its settings to
`~/.config/plasma-mobile/plasmamobilerc`.
2025-11-04 23:08:18 -05: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 SVN_SILENT made messages (.desktop file) - always resolve ours 2025-09-08 01:59:50 +00:00
components panels: Add support for defining device specific panel tweaks 2025-11-04 23:08:18 -05:00
containments panels: Add support for defining device specific panel tweaks 2025-11-04 23:08:18 -05:00
devices panels: Add support for defining device specific panel tweaks 2025-11-04 23:08:18 -05:00
envmanager panels: Add support for defining device specific panel tweaks 2025-11-04 23:08:18 -05:00
initialstart panels: Add support for defining device specific panel tweaks 2025-11-04 23:08:18 -05:00
kcms SVN_SILENT made messages (.desktop file) - always resolve ours 2025-10-09 10:44:41 +00:00
kded SVN_SILENT made messages (.desktop file) - always resolve ours 2025-09-09 02:09:50 +00:00
kwin panels: Add support for defining device specific panel tweaks 2025-11-04 23:08:18 -05:00
layout-templates panels: Add support for defining device specific panel tweaks 2025-11-04 23:08:18 -05:00
LICENSES kcm: split navbar to own kcm, add gesture tutorial 2025-09-05 12:44:32 +02:00
lookandfeel SVN_SILENT made messages (.desktop file) - always resolve ours 2025-09-09 02:09:50 +00:00
po GIT_SILENT Sync po/docbooks with svn 2025-11-04 01:54:47 +00:00
quicksettings kscreen: Make async calls and nullptr check 2025-11-03 22:44:26 -05:00
screenshots Remove trailing whitespace 2024-07-26 23:47:44 -04:00
shell panels: Add support for defining device specific panel tweaks 2025-11-04 23:08:18 -05:00
tests panel: Overlay over lockscreen 2025-07-02 10:27:33 -04: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 panels: Add support for defining device specific panel tweaks 2025-11-04 23:08:18 -05: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) 2025-10-20 00:44:34 +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 panels: Add support for defining device specific panel tweaks 2025-11-04 23:08:18 -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).