Skip to content

Releases

0.4.0: Linux hosts on Wayland

Choose a tag to compare

@kevguy kevguy released this 24 Oct 00:19

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

Choose a tag to compare

@kevguy kevguy released this 23 Oct 15:26

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 cc the 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-dev is 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.