mirror of
https://invent.kde.org/marcoa/shift-shell.git
synced 2026-04-26 14:23:09 +00:00
839d5e2bff
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`.
74 lines
3.2 KiB
Markdown
74 lines
3.2 KiB
Markdown
<!--
|
|
- SPDX-FileCopyrightText: None
|
|
- SPDX-License-Identifier: CC0-1.0
|
|
-->
|
|
|
|
# Plasma Mobile
|
|
|
|
This repository contains shell components for Plasma Mobile.
|
|
|
|
* Project page: [plasma-mobile.org](https://plasma-mobile.org)
|
|
* Repository: [invent.kde.org/plasma/plasma-mobile](https://invent.kde.org/plasma/plasma-mobile)
|
|
* Documentation: [invent.kde.org/plasma/plasma-mobile/-/wikis/home](https://invent.kde.org/plasma/plasma-mobile/-/wikis/home)
|
|
* Development channel: [matrix.to/#/#plasmamobile:matrix.org](https://matrix.to/#/#plasmamobile:matrix.org)
|
|
|
|
### Reporting issues
|
|
* How to report issues: [invent.kde.org/plasma/plasma-mobile/-/wikis/Issue-Tracking](https://invent.kde.org/plasma/plasma-mobile/-/wikis/Issue-Tracking)
|
|
* Shell issue tracker: [invent.kde.org/plasma/plasma-mobile/-/issues](https://invent.kde.org/plasma/plasma-mobile/-/issues)
|
|
* General issue tracker: [https://invent.kde.org/teams/plasma-mobile/issues/-/issues](https://invent.kde.org/teams/plasma-mobile/issues/-/issues)
|
|
|
|
### Locations
|
|
* [components/mobileshell](components/mobileshell) - private shell component library (API not guaranteed to be stable!)
|
|
* [containments](containments) - shell panels (homescreens, status bar, task panel)
|
|
* [kcms](kcms) - settings module
|
|
* [look-and-feel](look-and-feel/contents) - Plasma look-and-feel packages (ex. lockscreen, logout, etc.)
|
|
* [shell](shell) - Plasma shell package, provides implementations for applet and containment configuration dialogs
|
|
* [quicksettings](quicksettings) - quick settings packages for the action drawer
|
|
* [tests](tests) - small runnable snippets that can be used to test parts of the shell without loading all of Plasma
|
|
|
|
<img src="/screenshots/homescreen-folio.png" width=300px/>
|
|
<img src="/screenshots/homescreen-halcyon.png" width=300px/>
|
|
|
|
### Test on a development machine
|
|
|
|
See the [documentation page](https://invent.kde.org/plasma/plasma-mobile/-/wikis/Building-and-Testing-Locally) for more details.
|
|
|
|
It is recommended to use `kdesrc-build` to build this from source. See [this page](https://community.kde.org/Get_Involved/development) 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).
|
|
|
|
---
|
|
|
|
<img src="https://invent.kde.org/plasma/plasma-mobile/-/wikis/uploads/19a607bb68faa76bbc9f888e33a3aa9a/konqi-calling.png" width=200px>
|
|
|
|
<br/>
|
|
|
|
<img src="https://invent.kde.org/plasma/plasma-mobile/-/wikis/uploads/9238173a7cae1d8832d83350eda74f85/developers.png" width=300px>
|