gnome-49p8

This README contains unresolved ports variables; replace them before using its commands.

+-----------------------------------------------------------------------
| Running gnome on OpenBSD
+-----------------------------------------------------------------------

(see "Cheat sheet" at the end of this file for a quick setup)

The GNOME desktop is composed of 2 meta-packages:
    * gnome, for a standard GNOME installation
    * gnome-extras, for a full GNOME installation

The "gnome" package is focused on generic usage to give the user the
choice to install his favorite applications for daily usage (i.e. PIM,
WWW browser, office and development applications have been left out on
purpose).

Running GNOME
=============

DBus
----
GNOME needs a system-wide D-Bus daemon to be running:
    # rcctl enable messagebus
    # rcctl order messagebus

GDM
---
Session management requires the use of GDM as login manager, otherwise
some key features like screen locking, session tracking... will not work
properly.
    # rcctl disable xenodm
    # rcctl enable gdm

Locales
-------
Default language and character set for GNOME by the GDM greeter are set in:
    ${SYSCONFDIR}/gdm/locale.conf

Note that the variables set in this file will be inherited by the user session.
They can be unset/overriden in the user's .profile file or by using
gnome-control-center.

mDNS/DNS-SD support
===================

The avahi-daemon(8) daemon provides Zeroconf support (aka. Bonjour /
Rendezvous) in GNOME. Several applications can optionally benefit from
it (e.g. the "Network" shortcut in nautilus(1)) while some others
will not work at all without it (e.g. seahorse-sharing(1)).

To make use of it, multicast and avahi-daemon must be enabled:
    # rcctl enable multicast avahi_daemon

Audio/Video capture
===================

OpenBSD disables audio and video recording at the kernel level by default. If a
microphone source produces silence or a webcam source shows a black or blue
frame, enable recording with:
    # sysctl kern.audio.record=1
    # sysctl kern.video.record=1
To persist across reboots, add both lines to /etc/sysctl.conf.

The video(4) device also needs to be accessible by the user:
    # chown $USER /dev/video0
To persist across reboots, add the line to /etc/rc.local.

See https://www.openbsd.org/faq/faq13.html for details.

Google account integration
==========================

Linking a Google account to GNOME requires running the
${LOCALBASE}/libexec/goa-oauth2-handler helper from a web browser.
Most of them have can only access a subset of the filesystem due to unveil(2).

For Chrome-based browsers, append the following rules to
    ${SYSCONFDIR}/BROWSER/unveil.main
where BROWSER is one of chromium, iridium, or ungoogled-chromium:

# GNOME OAuth2 handler
${LOCALBASE}/libexec r
${LOCALBASE}/libexec/goa-oauth2-handler rx

Cheat sheet
===========
# rcctl disable xenodm
# rcctl enable multicast messagebus avahi_daemon gdm
# rcctl order messagebus
# reboot