File: phosh.rst

package info (click to toggle)
phosh 0.51.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky
  • size: 9,620 kB
  • sloc: ansic: 81,727; xml: 3,903; python: 502; sh: 456; makefile: 34; lisp: 22; javascript: 6
file content (74 lines) | stat: -rw-r--r-- 1,784 bytes parent folder | download | duplicates (2)
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
.. _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']"

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)``