2026-04-10 08:23:10 +00:00
|
|
|
# Shift
|
2021-12-23 16:02:41 +00:00
|
|
|
|
2026-04-10 08:23:10 +00:00
|
|
|
Convergence mode for Plasma Mobile. One shell that works as a phone and
|
|
|
|
|
adapts to a desktop when you connect a monitor, keyboard, or mouse.
|
2014-08-06 08:03:54 +00:00
|
|
|
|
2026-04-10 08:23:10 +00:00
|
|
|
Shift is a fork of [plasma-mobile](https://invent.kde.org/plasma/plasma-mobile).
|
|
|
|
|
The upstream phone UI is untouched; convergence adds a layer on top.
|
2014-11-13 20:29:24 +00:00
|
|
|
|
2026-04-10 08:23:10 +00:00
|
|
|
### What convergence mode changes
|
2022-04-08 23:27:31 +00:00
|
|
|
|
2026-04-10 08:23:10 +00:00
|
|
|
* Navigation panel replaced by a dock with running-app indicators,
|
|
|
|
|
favourites, context menus, and hover tooltips
|
|
|
|
|
* App drawer opens as a floating popup above the dock
|
|
|
|
|
* Window management: edge tiling, edge maximize, close buttons, task
|
|
|
|
|
context menus, Overview integration
|
|
|
|
|
* Status bar gains a system tray, date display, and hover highlights
|
|
|
|
|
* Screen space reserved for the dock via layer-shell exclusive zone
|
|
|
|
|
* Desktop niceties: right-click wallpaper settings, minimize-all on
|
|
|
|
|
home press, clickable page indicators
|
2022-01-18 16:02:38 +00:00
|
|
|
|
|
|
|
|
### Locations
|
2024-02-27 20:48:26 +00:00
|
|
|
|
2026-04-10 08:23:10 +00:00
|
|
|
* [components/mobileshell](components/mobileshell) - private shell component library
|
|
|
|
|
* [containments](containments) - shell panels (homescreens, status bar, task panel)
|
|
|
|
|
* [envmanager](envmanager) - convergence mode environment manager (kwinrc, etc.)
|
|
|
|
|
* [kwin/scripts](kwin/scripts) - KWin scripts for convergence window behaviour
|
|
|
|
|
* [kcms](kcms) - settings modules
|
|
|
|
|
* [look-and-feel](look-and-feel/contents) - Plasma look-and-feel packages
|
|
|
|
|
* [shell](shell) - Plasma shell package
|
|
|
|
|
* [quicksettings](quicksettings) - quick settings for the action drawer
|
2022-04-08 23:27:31 +00:00
|
|
|
|
2026-04-10 08:23:10 +00:00
|
|
|
### Building
|
2024-02-27 20:48:26 +00:00
|
|
|
|
|
|
|
|
```
|
2026-04-10 08:23:10 +00:00
|
|
|
cmake -B build
|
|
|
|
|
cmake --build build
|
|
|
|
|
cmake --install build
|
2024-02-27 20:48:26 +00:00
|
|
|
```
|
|
|
|
|
|
2026-04-10 08:23:10 +00:00
|
|
|
### Upstream
|
2022-04-08 23:27:31 +00:00
|
|
|
|
2026-04-10 08:23:10 +00:00
|
|
|
See [pm_README.md](pm_README.md) for the original Plasma Mobile README.
|
