table of contents
| PHOC() | PHOC() |
NAME¶
phoc - A Wayland compositor for mobile devices
SYNOPSIS¶
phoc [OPTIONS...]
DESCRIPTION¶
phoc is a Wayland compositor for mobile devices using the wlroots library. It's often used with the phosh mobile shell but works perfectly fine on its own.
OPTIONS¶
- -h, --help
- Print help and exit
- -C, --config FILE
- Path to the configuration file. (default: phoc.ini).
- -E, --exec EXECUTABLE
- Executable (session) that will be run at startup
- -S, --shell
- Whether to expect a shell to attach
- -X, --xwayland
- Whether to start XWayland
- --version
- Show version information
CONFIGURATION¶
Configuration is read from phoc.ini, hwdb and gsettings. For details on output configuration see phoc.ini(5), for details on wakeup key configuration via hwdb see gmobile.udev(5), for details on the gsettings handled by phoc see phoc.gsettings(5).
ENVIRONMENT VARIABLES¶
phoc honors the following environment variables:
- WLR_BACKENDS: The backends the wlroots library should use when phoc
launches. See
<https://gitlab.freedesktop.org/wlroots/wlroots/-/blob/master/docs/env_vars.md> - WLR_RENDERER: The renderer the wlroots library should use when phoc
launches. See
<https://gitlab.freedesktop.org/wlroots/wlroots/-/blob/master/docs/env_vars.md> - G_MESSAGES_DEBUG, G_DEBUG and other environment variables supported by glib. <https://docs.gtk.org/glib/running.html>
- PHOC_DEBUG: Comma separated list of debugging flags:
- help: Show a list of available debug flags
- auto-maximize: Maximize toplevels
- damage-tracking: Debug damage tracking
- no-quit: Don't quit when session ends
- touch-points: Debug touch points
- layer-shell: Debug layer shell
- cutouts: Debug display cutouts and notches
- disable-animations: Disable animations
- force-shell-reveal: Always reveal shell over fullscreen apps
DBUS INTERFACE¶
phoc 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.Phoc.DebugControl /mobi/phosh/Phoc/DebugControl mobi.phosh.Phoc.DebugControl
To toggle individual values:
busctl --user set-property mobi.phosh.Phoc.DebugControl /mobi/phosh/Phoc/DebugControl mobi.phosh.Phoc.DebugControl TouchPoints b true busctl --user set-property mobi.phosh.Phoc.DebugControl /mobi/phosh/Phoc/DebugControl mobi.phosh.Phoc.DebugControl DamageTracking b true
Note that the flags are not considered stable API so can change between releases.
SEE ALSO¶
phoc.ini(5) phoc.gsettings(5) gmobile.udev(5) phosh(1) busctl