mirror of
https://invent.kde.org/marcoa/shift-shell.git
synced 2026-06-11 08:57:21 +00:00
Rewrite the main project docs to present SHIFT as the product and Plasma Mobile as the upstream base. Keep compatibility-sensitive runtime identifiers such as org.kde.plasma.mobileshell and ~/.config/plasma-mobile explicit in the hacking guide instead of treating them as product identity.
40 lines
1.8 KiB
Markdown
40 lines
1.8 KiB
Markdown
# Shift
|
|
|
|
Shift is a fork of KDE Plasma Mobile focused on convergence.
|
|
When you connect a monitor, keyboard, or mouse, the same shell should still
|
|
work as a desktop-style environment. No second OS, no separate session.
|
|
|
|
## What's different from upstream
|
|
|
|
The upstream `plasma-mobile` repo provides the phone experience: homescreens,
|
|
a swipe-based navigation panel, an action drawer, and a status bar. All of
|
|
that still works. Shift adds a **convergence mode** layer on top — toggled
|
|
via `plasmamobilerc` — that swaps in desktop-oriented behaviour without
|
|
replacing the phone UI underneath.
|
|
|
|
Compatibility-sensitive runtime identifiers such as
|
|
`org.kde.plasma.mobileshell` remain upstream-looking for now. The product is
|
|
SHIFT; the preserved identifiers are part of the current compatibility layer.
|
|
|
|
Key changes so far:
|
|
|
|
- **Unified dock** replacing the navigation panel in convergence mode,
|
|
with running-app indicators, favourites, context menus, and hover
|
|
tooltips.
|
|
- **App drawer** opening as a centered popup instead of a full-screen
|
|
swipe.
|
|
- **Window management** — edge tiling, screen-edge maximize, close
|
|
buttons, task context menus, Overview integration.
|
|
- **Status bar** gains a system tray, date display, and hover highlights.
|
|
- **Screen space reservation** for the dock via a layer-shell exclusive
|
|
zone, so maximized windows don't overlap it.
|
|
- **Desktop niceties** — right-click wallpaper settings, minimize-all on
|
|
home press, clickable page indicators, action drawer toggle on click.
|
|
- **Thumbnail previews** on dock icon hover via PipeWire screencasting.
|
|
- **Pin to dock** — right-click a running app to pin it to favourites;
|
|
pinned apps get a "Remove from Dock" action.
|
|
|
|
## Upstream base
|
|
|
|
Forked from `plasma-mobile` at KDE's Plasma 6 branch. Upstream commits
|
|
(translations, silent fixes) are preserved in the early history.
|