Hysen Labsphosh
Read-only mirror of https://gitlab.gnome.org/World/Phosh/phosh
Phosh is a pure Wayland shell for Linux phones
Phosh is a pure Wayland shell for mobile devices such as smartphones and small tablets. This repository is a read only mirror of the upstream GNOME Phosh project, which targets touch first, battery powered hardware with limited screen space.
Target devices
Phosh is built for devices that use touch input, run on battery most of the time, have limited screen space and a limited number of buttons, and may dock to a keyboard, screen and other inputs. Typical hardware includes the Librem 5 and PinePhone, plus devices that formerly ran proprietary systems such as the OnePlus 6 and 6T. The companion Wayland compositor is called phoc, and phosh starts it under the hood through the phosh session script.
Building from source
The project uses the meson build system together with Ninja. The quickest start is meson setup followed by meson compile in a build directory, and on a Debian based system the dependencies install with apt build dep. Tests run under xvfb with meson test, and the main branch holds the current development version cloned from the GNOME GitLab. No files need to be installed outside the source tree to try it.
Running the shell
From the source tree, starting phoc and then phosh shows the shell, and a display manager such as GDM or LightDM can select the Phosh session. For development a provided systemd unit starts phosh as a user, and the result looks like the overview screenshot shipped in the repository. Translations are handled through GNOME infrastructure, and the issue tracker and Matrix room are the ways to reach the project.
Editorial conclusion
Phosh is licensed under GPL version 3 or later and is written in C. This mirror tracks the upstream GNOME World Phosh repository on GitLab.
Community notes