Manpage logo

phosh - A phone shell

NAME  SYNOPSIS  DESCRIPTION  OPTIONS  CONFIGURATION  Plugins  ENVIRONMENT VARIABLES  SEE ALSO 

NAME

phosh − Phosh - A phone shell

SYNOPSIS

phosh [OPTIONS...]

DESCRIPTION

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

OPTIONS

−h, −−help

Print help and exit

−U, −−unlocked

Don't start with screen locked

−L, −−locked

Start with screen locked, no matter what

−−version

Show version information

CONFIGURATION

phosh is configured via GSettings, see phosh−config(5).

Plugins

Plugins are configured via the mobi.phosh.plugins and 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']"

ENVIRONMENT VARIABLES

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)

fake−builtin: Fake a builtin screen when using a virtual output like in a nested Wayland session.

PHOSH_FAKE_CLOCK: Allowed values are ISO8601 formatted strings or now. Setting this variable sets the shell's clocs to the given fixed value. For the clock format see g_date_time_new_from_iso8601().

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>

SEE ALSO

gsettings(1) phosh−session(1) phosh.gsettings(5)


Updated 2026-06-01 - jenkler.se | uex.se