wlroots based Phone compositor as used on the Librem5.
Phoc is pronounced like the English word fog.
On a Debian based system run:
sudo apt-get -y install build-essential
sudo apt-get -y build-dep .For an explicit list of dependencies check the Build-Depends entry in the
debian/control file.
We use the meson (and thereby Ninja) build system for phoc. The quickest way to get going is to do the following:
meson setup _build
meson compile -C _build
meson install -C _build --skip-subprojectsThis assumes you have wlroots installed on your system. If you don't have that and/or want to build from source run:
meson -Dembed-wlroots=enabled --default-library=static _build
meson compile -C _buildThis will fetch a matching version of wlroots and build that as well.
To run from the source tree use
./_build/runAfter making source changes run
xvfb-run meson test -C _buildto see if anything broke.
phoc's behaviour can be configured via GSettings. For your convienience,
a set of scripts to manipulate config values is available in helpers
directory.
-
scale-to-fittoggles automatic scaling of applications that don't fit the screen. This setting is enabled per application using its reported app-id. For instance, to enable scaling of GNOME Maps windows use:./helpers/scale-to-fit org.gnome.Maps on -
auto-maximizetoggles automatic maximization of Wayland windows. Disabling it allows windows to be resized and moved, which may be desired when running phoc on desktop-like setups../helpers/auto-maximize off
Outputs are configured via phoc.ini config file - see src/phoc.ini.example
for more information.
phoc uses glib so the G_MESSAGES_DEBUG environment variable can be
used to enable more log messages and G_DEBUG to assert on warnings
and criticals. The log domains all start with phoc- and are usally
phoc-<sourcefile>. All wlroots related messages are logged with
phoc-wlroots.
For more details on these environment variables, read the documentation for GLib.
There's also a PHOC_DEBUG enviroment variable to turn on some debugging
features. Use PHOC_DEBUG=help phoc to see supported flags.
API documentation is available at https://world.pages.gitlab.gnome.org/Phosh/phoc/
