Phosh: Difference between revisions
→Apps: gnome-software *does* support apk now, and it supports flatpaks, too |
No edit summary |
||
Line 36: | Line 36: | ||
== Apps == | == Apps == | ||
Moved to [[User:MartijnBraam/Phosh_Apps]]. | |||
Revision as of 13:38, 28 August 2020
Phosh is a mobile desktop interface based on the GNOME stack. It was originally created for Purism's Librem 5, but can be used on any device.
Installation
Using pmbootstrap
, Phosh can be installed by selecting it as the UI in pmbootstrap init
.
On existing systems, it can be installed by installing the postmarketos-ui-phosh
meta package or phosh
if postmarketOS specific customization is not wanted.
When running pmbootstrap install
to flash a phone or sd card you'll be prompted for a user password. Make sure to only use numeric characters [0-9] in this password as the phosh lock screen uses this password as a pin. On an existing phosh install you can change your user password and pin in the terminal with the standard passwd
command.
Starting Phosh
If postmarketos-ui-phosh
is installed, Phosh will be automatically launched via the LightDM display manager.
It can also be launched manually by running dbus-run-session /usr/bin/phosh
.
Modem
Phosh should start up the modem automatically, and display a "locked" sign if you need to type in a PIN. The patches to make GNOME dialogs fit phone screens are only rolled out on the v20.05 branch (stable channel, not edge; pmaports#690). If you have trouble configuring everything with the graphical dialogs or just want to use the terminal, read along.
Unlock your SIM card with the PIN:
mmcli -i 0 --pin=12345
Configure your APN for mobile data (example for mobile vikings in Belgium):
mmcli -m 0 --simple-connect='apn=web.be,user=web,password=web,pin=1111'
Screen Scaling
The Phosh screen may be scaled lower for better compatibility with existing applications. Change the scale by modifying the scale factor variable found in /usr/share/phosh/phoc.ini, which has a default value of 2.
Screen scaling may also be performed on-demand from the command line or by making an application by following the Purism Easy Librem 5 App Development: Scale the Screen blog post. Those instructions work well for devices running Phosh even if written for a Librem5 running PureOS (Debian-based OS). Keep in mind some commands will need to be modified to work on postmarketOS.
Apps
Moved to User:MartijnBraam/Phosh_Apps.