1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
.. _phosh(1):
=====
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)
- ``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)``
|
