Repository navigation
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.