Jump to content

Phosh: Difference between revisions

From postmarketOS Wiki
Afontain (talk | contribs)
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]].
{| class="wikitable"
! App
! Is
! Mobile
! Notes
|-
| gnome-2048
| game
| Yes
|
|-
| gnome-authenticator
| totp
| Yes
| QR scanner is broken
|-
| gnome-books
| ebook reader
|
| Too large for screen
|-
| gnome-boxes
| virtual machine
|
| Too large for screen
|-
| gnome-calculator
| calculator
| Yes
| [https://source.puri.sm/Librem5/gnome-calculator/commits/librem5-3-34-1 phosh patches for focus issue]
|-
| gnome-calendar
| calendar
|
| Slightly too large for screen
|-
| cheese
| camera
|
| Too large for screen, doesn't support ARM cameras
|-
| gnome-clocks
| alarms
| Yes
| Alarms are silent, possibly phosh issue
|-
| gnome-contacts
| contact manager
|
| No icon, doesn't allow creating local address book, [https://source.puri.sm/Librem5/gnome-contacts/commits/librem5 phosh patches]
|-
| baobab
| disk usage analyzer
|
| Too large
|-
| gnome-disks
| disk management
|
| Might work, detects no devices
|-
| simple-scan
| document scanner
|
| Slightly too large, requires cups setup first which is broken
|-
| evince
| document viewer
|
| Too large [https://source.puri.sm/Librem5/evince/commits/librem5-3-34-1 phosh patches]
|-
| epiphany
| browser
|
| crash on javascript [https://source.puri.sm/Librem5/epiphany/tree/librem5-3-34-1 purism patches]
|-
| gnome-feeds
| rss
|
| doesn't launch
|-
| nautilus
| file browser
|
| non optimal layout in portrait
|-
| fractal
| matrix client
| Yes
|
|-
| gnome-games
| game browser
|
| Too large gnome dialogs
|-
| geary
| mail client
|
| Too large
|-
| gnome-latex
| latex editor
|
| Too large
|-
| gnote
| notes
| Yes
| Weird layout for phone
|-
| eog
| image viewer
| Yes
| Bad hdpi rendering and sidebar is annoying
|-
| gnome-maps
| openstreetmaps
|
| Too large to fit in screen, casual scrolling the map works fine
|-
| gnome-music
| music player
|
| Too large to fit in screen
|-
| gnome-usage
| system monitor
|
| Too large [https://source.puri.sm/Librem5/gnome-usage/commits/librem5-3-32-0 phosh patches]
|-
| peek
| screen recorder
|
| Doesn't launch
|-
| gnome-photos
| photo manager
|
| Too large
|-
| gnome-podcasts
| podcasts
| Yes
| player bar slightly too large
|-
| polari
| irc client
|
| Doesn't launch
|-
| vinagre
| remote desktop client
|
| Messed up layout
|-
| rhythmbox
| music player
| Yes
| Fits but with some layout issues
|-
| gnome-shortwave
| internet radio
| Yes
| Not very stable, probably radio stations fault
|-
| shotwell
| photo manager
|
| Too large for screen
|-
| gnome-software
| package manager
|
| Slightly too large for screen, apk and flatpak support (add a remote), [https://source.puri.sm/Librem5/gnome-software/commits/librem5-3-34-0 phosh patches]
|-
| gnome-sound-recorder
| sound recorder
|
| Too large for screen
|-
| gnome-system-monitor
| taskmanager
|
| Slightly too large for screen
|-
| kgx
| terminal emulator
| Yes
|
|-
| gedit
| text editor
| Yes
| [https://source.puri.sm/Librem5/gedit/commits/librem5-3-34-0 phosh patches]
|-
| totem
| video player/browser
|
| Too large for screen
|-
| gnome-weather
| weather
|
| Too large for screen
|}
 
Purism seems to be using these unpackaged apps in their Phosh:
 
* https://source.puri.sm/Librem5/lollypop
* https://source.puri.sm/Librem5/folks
* https://source.puri.sm/Librem5/tinymail ?

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.