Repository navigation
Releases
0.4.0: Linux hosts on Wayland
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.
0.2.0: Linux hosts
Host screen now works on Linux hosts running an X11 desktop session, as well as Macs.
Linux hosts
- A native C helper captures the screen, sends mouse and keyboard input through XTest, and syncs the text clipboard both ways. It is compiled with
ccthe first time the screen opens. - Install the build packages first. On Debian or Ubuntu:
sudo apt install gcc libx11-dev libxext-dev libxtst-dev libxrandr-dev libxfixes-dev libjpeg-dev
(libxtst-devis the one most desktops lack.) The README lists the Fedora and Arch packages. - No permissions to grant. Paseo must run inside the desktop session; Wayland sessions are not supported yet.
- Displays show their monitor names, and laptop panels show as Built-in. With no display chosen yet, the viewer starts on the display with the focused window.
- The key bar has GNOME shortcuts: Super+Tab, Activities, Apps, Ctrl+W, Alt+F4 and switching workspaces.
- From a Mac client, ⌘ shortcuts are sent as Ctrl. Windows and Linux clients use Ctrl+V and Ctrl+C for clipboard sync. Add Shift to paste into a terminal.
Mac hosts
No change in behaviour. The Swift helper is the same, so hosts keep their compiled helper.
Known limits on Linux
- Characters outside Latin-1 (Cyrillic, Greek, €) are typed through a remapped spare key, at about 30 ms each.
- Waking a blanked display and typing on the GNOME lock screen are untested.