DOKK / manpages / debian 12 / phosh / phosh.1.en
PHOSH() PHOSH()

phosh - Phosh - A phone shell

phosh [OPTIONS...]

phosh is a Wayland shell for mobile devices using GNOME technologies.

Print help and exit
Don't start with screen locked
Start with screen locked, no matter what
Show version information

phosh is configured via GSettings. The core settings are within th sm.puri.phosh schema. See also https://gitlab.gnome.org/World/Phosh/phosh/-/wikis/Configuration

Plugins are configured via the sm.puri.phosh.plugins gsettings schema. The lock-screen key enables the plugins on the lock screen e.g.

gsettings set  sm.puri.phosh.plugins lock-screen "['ticket-box', 'upcoming-events']"


phosh honors the following environment variables for debugging purposes:

PHOSH_DEBUG: A comma separated list of flags:
always-splash: Always use splash screen when starting apps (even when in docked mode)



  • G_MESSAGES_DEBUG, G_DEBUG and other environment variables supported by glib. https://docs.gtk.org/glib/running.html
  • GTK_DEBUG and other environment variables supported by GTK, see https://docs.gtk.org/gtk3/running.html

gsettings(1) phosh-session(1)