.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "phosh" "" "" ""
.SH Name
phosh \- Phosh - A phone shell
.SH SYNOPSIS
.nf
\fBphosh\fP [OPTIONS...]
.fi
.sp
.SH DESCRIPTION
.sp
\fBphosh\fP is a Wayland shell for mobile devices using GNOME technologies.
.SH OPTIONS
.INDENT 0.0
.TP
.B \fB\-h\fP, \fB\-\-help\fP
Print help and exit
.TP
.B \fB\-U\fP, \fB\-\-unlocked\fP
Don\(aqt start with screen locked
.TP
.B \fB\-L\fP, \fB\-\-locked\fP
Start with screen locked, no matter what
.TP
.B \fB\-\-version\fP
Show version information
.UNINDENT
.SH CONFIGURATION
.sp
\fBphosh\fP is configured via \fBGSettings\fP, see \fBphosh\-config(5)\fP\&.
.SS Plugins
.sp
Plugins are configured via the \fBmobi.phosh.plugins\fP and \fBsm.puri.phosh.plugins\fP gsettings
schema. The \fBlock\-screen\fP key enables the plugins on the lock screen
e.g.
.INDENT 0.0
.INDENT 3.5
.sp
.EX
gsettings set  sm.puri.phosh.plugins lock\-screen \(dq[\(aqticket\-box\(aq, \(aqupcoming\-events\(aq]\(dq
.EE
.UNINDENT
.UNINDENT
.SH DBUS INTERFACE
.sp
\fBphosh\fP allows to enable and disable certain debug flags at runtime via DBus. To see a list of
available flags use:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
busctl \-\-user introspect mobi.phosh.Shell.DebugControl /mobi/phosh/Shell/DebugControl mobi.phosh.Shell.DebugControl
.EE
.UNINDENT
.UNINDENT
.sp
To toggle individual values:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
busctl \-\-user set\-property mobi.phosh.Shell.DebugControl /mobi/phosh/Shell/DebugControl mobi.phosh.Shell.DebugControl LogDomains as 2 phosh\-shell phosh\-brightness\-manager
.EE
.UNINDENT
.UNINDENT
.sp
Note that the flags are not considered stable API so can change
between releases.
.SH ENVIRONMENT VARIABLES
.sp
\fBphosh\fP honors the following environment variables for debugging purposes:
.INDENT 0.0
.IP \(bu 2
\fBPHOSH_DEBUG\fP: A comma separated list of flags:
.INDENT 2.0
.INDENT 3.5
.INDENT 0.0
.IP \(bu 2
\fBalways\-splash\fP: Always use splash screen when starting apps
(even when in docked mode)
.IP \(bu 2
\fBapp\-activation\fP: Use longer timeout before force\-closing the app
splash. Enable this flag to help debug activation issues.
.IP \(bu 2
\fBbacklight\-non\-linear\fP: Assume backlight brightness changes \fInon\-linear\fP\&.
Set if kernel should report the backlight as \fInon\-linear\fP but doesn\(aqt.
.IP \(bu 2
\fBfake\-builtin\fP: Fake a builtin screen when using a virtual output like
in a nested Wayland session.
.IP \(bu 2
\fBthumbnail\-overlay\fP: Use animated transition between overlay and running
app. This will default to on in future releases.
.UNINDENT
.UNINDENT
.UNINDENT
.IP \(bu 2
\fBPHOSH_FAKE_CLOCK\fP: Allowed values are ISO8601 formatted strings
or \fBnow\fP\&. Setting this variable sets the shell\(aqs clocs to the
given fixed value. For the clock format see \fBg_date_time_new_from_iso8601()\fP\&.
.IP \(bu 2
\fBG_MESSAGES_DEBUG\fP, \fBG_DEBUG\fP and other environment variables supported
by glib. \%<https://\:docs\:.gtk\:.org/\:glib/\:running\:.html>
.IP \(bu 2
\fBGTK_DEBUG\fP and other environment variables supported by GTK, see
\%<https://\:docs\:.gtk\:.org/\:gtk3/\:running\:.html>
.UNINDENT
.SH See also
.sp
\fBgsettings(1)\fP \fBphosh\-session(1)\fP \fBphosh.gsettings(5)\fP
.\" End of generated man page.