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']"
DBUS INTERFACE
phosh allows to enable and disable certain debug flags at runtime via DBus. To see a list of available flags use:
busctl --user introspect mobi.phosh.Shell.DebugControl /mobi/phosh/Shell/DebugControl mobi.phosh.Shell.DebugControl
To toggle individual values:
busctl --user set-property mobi.phosh.Shell.DebugControl /mobi/phosh/Shell/DebugControl mobi.phosh.Shell.DebugControl LogDomains as 2 phosh-shell phosh-brightness-manager
Note that the flags are not considered stable API so can change between releases.
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)
- •
-
app-activation: Use longer timeout before force-closing the app splash. Enable this flag to help debug activation issues.
- •
-
backlight-non-linear: Assume backlight brightness changes non-linear. Set if kernel should report the backlight as non-linear but doesn't.
- •
-
fake-builtin: Fake a builtin screen when using a virtual output like in a nested Wayland session.
- •
-
thumbnail-overlay: Use animated transition between overlay and running app. This will default to on in future releases.
- •
-
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>