Skip to content

0.4.0: Linux hosts on Wayland

Latest

Choose a tag to compare

@kevguy kevguy released this 24 Oct 00:19
· 12 commits to main since this release

Host screen now works on Linux hosts running Wayland (the default on current Ubuntu, Fedora and GNOME), as well as X11 and Macs.

Linux hosts on Wayland

  • The helper goes through the desktop's own portals: it reads the screen over PipeWire with GStreamer and sends mouse, keyboard and clipboard through the RemoteDesktop and Clipboard portals. It is compiled the first time the screen opens.
  • Install the build packages first. On Debian or Ubuntu:
    sudo apt install gcc pkg-config libglib2.0-dev libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev libjpeg-dev gstreamer1.0-pipewire
    The README lists the Fedora and Arch packages.
  • The first time a viewer opens, it offers Show prompt on host, and the desktop's screen sharing dialog appears there. Someone at the host turns on Allow Remote Interaction (off by default; without it the screen can only be watched) and Allow Clipboard Access, then chooses Share. The approval is remembered.
  • One helper process serves frames and input on Wayland, so a host has one sharing session and one approval.
  • Stop sharing in the desktop's sharing indicator drops the approval; sharing stays off until someone at the host approves again.
  • GNOME ends sharing while the screen is locked. The approval is kept, and sharing resumes by itself once the screen is unlocked at the host.
  • Tested on GNOME 50 (Ubuntu 26.04) with one display, including a 4K panel at 200% scaling.

Headless and always-on Linux hosts

A new README section covers running the Paseo daemon outside the desktop session: how the plugin picks the desktop to share, what sharing the physical Wayland screen needs (a logged-in, unlocked session), and a virtual desktop (Xvfb + XFCE with systemd user services) for machines nobody sits at. The viewer no longer shows a lock banner for virtual X displays (Xvfb, Xvnc, Xephyr).

Windows hosts (experimental, from 0.3.0)

0.3.0 added experimental Windows 10 and 11 hosts (GDI capture and SendInput, compiled with the .NET Framework's csc.exe) without a GitHub release. It is built and reviewed but not yet tested on a real Windows host.

Mac and X11 hosts

No change in behaviour, apart from X11 lock detection, which now also reads logind's LockedHint.

Known limits

  • On Wayland, characters the host's keyboard layout lacks (✓, emoji, é on a US layout) can't be typed; paste them instead.
  • Multiple displays and other Wayland desktops (KDE, Sway, Hyprland) are untested.
  • On GNOME, stopping sharing and then locking the screen within about 2 seconds counts as a lock, so sharing resumes after unlock.
  • On a second X11 session such as xrdp or X2Go, the viewer may show a lock banner when the machine's own screen locks.