Xpra Clients

Any application that speaks the xpra network protocol can be used as an xpra client.
The reference implementation is the xpra client shipped with the xpra server itself, but a number of alternative clients exist, with varying degrees of completeness.

Servers negotiate their capabilities with each client during the hello handshake, so features that a client does not implement are simply not enabled for that connection.

Client implementations

| Client | Maintained by | License | |------------------------------------------------------|----------------------------------------------|---------| | xpra | Xpra-org | GPLv2 | | xpra-html5 | Xpra-org | MPL-2.0 | | vispra | third party | MIT | | rust-xpra | Xpra-org | GPLv3 | | go-xpra | Xpra-org | GPLv3 |

The xpra client is the default client: it is the only one that implements the complete feature set, and the only one available as a native package for Linux, MS Windows and MacOS.
The two browser based clients, xpra-html5 and vispra, are served over ws / wss connections - the xpra server's builtin web server will pick up xpra-html5 automatically when it is installed.
The rust and go clients are smaller native implementations with a deliberately limited feature set, also used for validating the protocol.

Project size and build

These are not the same kind of project, and what it costs to build and ship them differs by two orders of magnitude:

| Client | Languages | Source | Binaries | Build time | |------------|----------------------------------|----------------------|----------------------------------------------------------|------------------------------------------| | xpra | Python 3, Cython, C, CUDA - GTK3 | 1550 files, 318 kloc | 4-9 MB packages, 106 MB .exe, 72-88 MB .dmg / .pkg | 4 minutes, over 10 on MS Windows / MacOS | | xpra-html5 | JavaScript, no framework | 32 files, 18 kloc | 2.0-2.2 MB package, 2.2 MB served to the browser | 30 seconds | | vispra | TypeScript, SolidJS, Vite | 117 files, 24 kloc | 2.8 MB served to the browser, no packages | 10 seconds | | rust-xpra | Rust, winit / softbuffer | 32 files, 9 kloc | 2.4-2.8 MB package, 2.6 MB executable | 90 seconds | | go-xpra | Go, no cgo, no toolkit | 83 files, 14 kloc | 3.9-4.2 MB package, 7.5 MB executable, 4.5 MB .exe | 35 seconds |

Source counts tracked files in each project's own languages, tests included and vendored libraries excluded - the xpra-html5 figure leaves out some 70 kloc of bundled jquery and audio decoders, whereas vispra gets the equivalent from npm and never commits it. Of xpra's 318 kloc, 259 are Python, 49 Cython and 10 C and CUDA.
The package sizes are what the xpra repositories serve, and they only look small because a distribution package leans on the distribution's own Python, GTK and codec libraries; the MS Windows installer and the MacOS .dmg / .pkg carry all of that themselves, which is the whole difference between 4 MB and 106 MB.
Build times are wall clock, from cold, on one 8 thread x86_64 desktop, with the dependencies already installed. Only xpra's is long enough to matter, and it is much longer on the two platforms that also build the toolchain, the bundled libraries and an installer.

Feature comparison

This comparison should be correct as of 2026-08-02 00:20 +0700, the last time it was checked against each client's repository.

Legend: ๐ŸŸข supported ยท ๐ŸŸ  partial, platform-limited or degraded ยท ๐Ÿ”ด absent

Rows that name their options carry one marker per option, in that order: ws also covers wss, and quic also covers the browsers' WebTransport.

| Feature | xpra | html5 | vispra | rust | go | |--------------------------------------------|:-----:|:-----:|:------:|:-----:|:-----:| | Transports (tcp/ssl/ssh/ws/quic) | ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข | ๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด๐ŸŸข๐ŸŸ  | ๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด๐ŸŸข๐ŸŸ  | ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐Ÿ”ด | ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐Ÿ”ด | | Transport security (tls/ssh/aes) | ๐ŸŸข๐ŸŸข๐ŸŸข | ๐ŸŸข๐Ÿ”ด๐ŸŸข | ๐ŸŸข๐Ÿ”ด๐ŸŸข | ๐ŸŸข๐ŸŸข๐Ÿ”ด | ๐ŸŸข๐ŸŸข๐Ÿ”ด | | Authentication | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | | Packet encoding (rencodeplus/yaml) | ๐ŸŸข๐ŸŸข | ๐ŸŸข๐Ÿ”ด | ๐ŸŸข๐Ÿ”ด | ๐Ÿ”ด๐ŸŸข | ๐ŸŸข๐Ÿ”ด | | Compression in (lz4/zstd/brotli) | ๐ŸŸข๐ŸŸข๐ŸŸข | ๐ŸŸข๐Ÿ”ด๐ŸŸข | ๐ŸŸข๐Ÿ”ด๐ŸŸข | ๐ŸŸข๐Ÿ”ด๐Ÿ”ด | ๐ŸŸข๐Ÿ”ด๐Ÿ”ด | | Compression out (lz4/zstd/brotli) | ๐ŸŸข๐ŸŸข๐ŸŸข | ๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด | ๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด | ๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด | ๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด | | Packet types | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | | Out-of-band chunks | ๐ŸŸข | ๐ŸŸข | ๐ŸŸข | ๐ŸŸข | ๐ŸŸข | | Forwarded windows | ๐ŸŸข | ๐ŸŸข | ๐ŸŸข | ๐ŸŸข | ๐ŸŸข | | Advanced window state | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | | Override-redirect popups | ๐ŸŸข | ๐ŸŸข | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸข | | Picture encodings (rgb/jpeg/png/webp/avif) | ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข | ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸ  | ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸ  | ๐Ÿ”ด๐ŸŸข๐ŸŸข๐ŸŸข๐Ÿ”ด | ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐Ÿ”ด | | Video encodings (h264/vp8/vp9/av1) | ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข | ๐ŸŸข๐ŸŸข๐Ÿ”ด๐Ÿ”ด | ๐ŸŸข๐ŸŸข๐Ÿ”ด๐Ÿ”ด | ๐ŸŸ ๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด | ๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด | | Accelerated rendering | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | | Speaker audio (opus/vorbis/mp3/flac/aac) | ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข | ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข | ๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข๐ŸŸข | ๐ŸŸ ๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด | ๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด๐Ÿ”ด | | Microphone | ๐ŸŸข | ๐Ÿ”ด | ๐Ÿ”ด | ๐Ÿ”ด | ๐Ÿ”ด | | Clipboard | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | ๐Ÿ”ด | | Keyboard | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | | Pointer / input | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | | Server cursors | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | | Window icons | ๐ŸŸข | ๐ŸŸข | ๐Ÿ”ด | ๐ŸŸ  | ๐ŸŸข | | Bell forwarding | ๐ŸŸข | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | | Desktop notifications | ๐ŸŸข | ๐ŸŸข | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | | Client tray / menu | ๐ŸŸข | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | ๐Ÿ”ด | | Remote app system tray | ๐ŸŸข | ๐ŸŸข | ๐ŸŸ  | ๐Ÿ”ด | ๐Ÿ”ด | | File transfer / URLs | ๐ŸŸข | ๐ŸŸข | ๐ŸŸ  | ๐Ÿ”ด | ๐Ÿ”ด | | Printer forwarding | ๐ŸŸข | ๐ŸŸข | ๐ŸŸ  | ๐Ÿ”ด | ๐Ÿ”ด | | Webcam forwarding | ๐ŸŸข | ๐Ÿ”ด | ๐Ÿ”ด | ๐Ÿ”ด | ๐Ÿ”ด | | Shared memory | ๐ŸŸข | ๐Ÿ”ด | ๐Ÿ”ด | ๐ŸŸ  | ๐Ÿ”ด | | DPI / display sync | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | | Remote logging / events | ๐ŸŸข | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | ๐ŸŸ  | | Bandwidth adaptation | ๐ŸŸข | ๐ŸŸ  | ๐ŸŸ  | ๐Ÿ”ด | ๐Ÿ”ด |

The sections below detail what each client actually implements.

Native xpra client

The reference implementation and the only complete one: a production client packaged for Linux, MS Windows and MacOS.

| Feature | Notes | |-------------------------|----------------------------------------------------------------------------------------------------| | Transports | Also Unix sockets, named pipes and vsock; VNC support | | Authentication | Password, prompt, file, URI, SCRAM, Kerberos, GSS, U2F/FIDO2 and others | | Packet types | Legacy and 6.5+ names, selected with XPRA_BACKWARDS_COMPATIBLE | | Advanced window state | Shapes, workspaces, transient relationships, fullscreen, stacking, decorations, constraints, grabs | | Picture encodings | Also scroll, and others depending on the codecs installed | | Video encodings | HEVC and others too, depending on decoder availability | | Accelerated rendering | OpenGL plus VAAPI, NVIDIA, Media Foundation, VideoToolbox and other optional paths | | Speaker audio | Negotiated through GStreamer, in a choice of containers | | Clipboard | Multiple selections / targets, direction controls and filtering | | Keyboard | Full keymap upload / synchronization, layouts, shortcuts and lock-state handling | | Pointer / input | Pointer, buttons, wheel, focus, relative input, grabs and XI2 support | | Server cursors | raw and png, local themed cursors by name, desktop scaling and size negotiation | | Bell forwarding | Native platform backend | | Desktop notifications | Native notification backends on supported platforms | | Client tray / menu | Extensive session controls | | Printer forwarding | Optional platform dependencies | | Webcam forwarding | Optional; client camera โ†’ Linux server | | Shared memory | mmap, in both directions, for sessions on the same host | | DPI / display sync | DPI, scaling, monitor layout, workspaces and high bit depth | | Remote logging / events | Full diagnostics, session info and event handling | | Bandwidth adaptation | Detection, limits, codec adaptation and detailed latency metrics |

xpra-html5

Production client, widely deployed; runs in any modern browser.

| Feature | Notes | |-------------------------|------------------------------------------------------------------------------------------------| | Transports | The quic marker is WebTransport, still experimental | | Transport security | HTTPS/WSS through the browser's TLS stack; application-level AES (CBC/CTR/CFB) | | Authentication | HMAC-SHA256 password; refuses to send passwords over unencrypted remote links | | Packet types | Legacy names, both directions | | Forwarded windows | Create / destroy / draw / move / resize / raise | | Advanced window state | Fullscreen, maximize/minimize, above/below, modal and opacity, confined to the browser canvas | | Picture encodings | Also scroll; RGB is lz4 compressed, and WebP and AVIF are validated in a decode worker first | | Video encodings | H.264 and VP8 through WebCodecs, MPEG4 / VP8 through MediaSource | | Accelerated rendering | Browser-native decoding, offscreen canvas and decode workers; no GPU control | | Speaker audio | Through MediaSource, with an aurora fallback | | Clipboard | Text and HTML, CLIPBOARD selection only, subject to browser permissions | | Keyboard | Layout selection and browser keycodes; no keymap upload | | Pointer / input | Pointer, buttons, wheel, focus and pointer lock | | Server cursors | PNG only, rescaled for the browser zoom; no cursor names, no size negotiation | | Window icons | PNG icons, in the title bar, the window list and the page favicon | | Bell forwarding | Audio sample | | Desktop notifications | Browser notifications | | Client tray / menu | Floating toolbar with session controls | | File transfer / URLs | Downloads and URL opening | | Printer forwarding | Through the browser's print dialog | | DPI / display sync | DPI and screen size reported, resizes with the browser window | | Remote logging / events | Remote logging, session info and diagnostics | | Bandwidth adaptation | Bandwidth limit option, pings and latency metrics |

vispra

Early stage third party rewrite of the html5 client; runs in any modern browser.

| Feature | Notes | |-------------------------|-----------------------------------------------------------------------| | Transports | The quic marker is WebTransport, still experimental | | Transport security | HTTPS/WSS through the browser's TLS stack; application-level AES | | Authentication | HMAC-SHA256 password | | Packet types | Legacy names, both directions | | Forwarded windows | Create / destroy / draw / move / resize / raise | | Advanced window state | A subset of the html5 client's, also confined to the browser canvas | | Picture encodings | Also scroll; RGB is lz4 compressed, AVIF subject to browser support | | Video encodings | H.264 and VP8 through WebCodecs | | Accelerated rendering | Browser-native decoding, offscreen canvas and decode workers | | Speaker audio | Through MediaSource, with an aurora fallback | | Clipboard | Plain text, subject to browser permissions | | Keyboard | Layout selection and browser keycodes; no keymap upload | | Pointer / input | Pointer, buttons, wheel and focus | | Server cursors | PNG only, at the size the server sends; no cursor names, no scaling | | Window icons | Decoded and dropped: every window shows the same branding icon | | Bell forwarding | Tone generated with the Web Audio API | | Desktop notifications | Browser notifications | | Client tray / menu | Taskbar and session info panel | | Remote app system tray | Tray windows are received and rendered | | File transfer / URLs | Basic file reception | | Printer forwarding | Present but disabled by default | | DPI / display sync | DPI and screen size reported, resizes with the browser window | | Remote logging / events | Remote logging, session info and pings | | Bandwidth adaptation | Bandwidth limit option and pings |

Rust client

Runs on MS Windows and on Linux, X11 or Wayland; requires an xpra 6.6 or later server, left in its default backwards-compatible mode.

| Feature | Notes | |--------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------| | Transports | ssh shells out to the system client | | Transport security | Certificate and hostname verification against the system trust store, --ssl-insecure opts out; no private CA option, no application-level AES | | Authentication | HMAC-SHA256 password via connection dialog, environment, pinentry or built-in dialog | | Packet types | Sends 6.5+ names, receives legacy: needs a 6.6+ server left in its backwards-compatible mode | | Out-of-band chunks | Received from the server | | Forwarded windows | Create / destroy / draw / move / resize / raise | | Advanced window state | Fullscreen, maximize/minimize, decorations, above/below, constraints and interactive moves | | Override-redirect popups | Real override-redirect on X11 only: undecorated but focus-stealing toplevels on MS Windows, placed by the compositor on Wayland | | Video encodings | H.264 on Windows through Media Foundation | | Accelerated rendering | Media Foundation H.264 on Windows; CPU softbuffer otherwise | | Speaker audio | Bare Opus on Windows only, with jitter buffering and AV sync | | Clipboard | Bidirectional plain text, CLIPBOARD selection only; X11/XWayland or Windows | | Keyboard | Direct key events; no keymap upload, NumLock limitation on Wayland | | Pointer / input | Pointer, buttons, wheel, focus and server-requested grabs | | Server cursors | PNG only, at the size the server sends; no cursor names, no scaling | | Window icons | PNG icons on X11 and MS Windows; winit ignores them on Wayland | | Bell forwarding | Windows tone; terminal BEL on Linux | | Desktop notifications | Windows tray balloons; logged on Linux | | Client tray / menu | Windows only, with an Exit command | | Shared memory | mmap on Linux, server โ†’ client only, on by default; not on MS Windows | | DPI / display sync | Windows DPI-aware manifest; no server DPI / monitor synchronization | | Remote logging / events | Remote logging, lifecycle events and pings | | Bandwidth adaptation | Pings only |

Go client

Minimal client, usable on three window systems: Linux X11, Linux Wayland and MS Windows.

| Feature | Notes | |--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Transports | ssh shells out to the system client | | Transport security | TLS certificate and hostname verification against the system trust store for ssl/wss, private CA option; SSH through the system client; no application-level AES | | Authentication | HMAC-SHA256 password via URL, connection dialog, XPRA_PASSWORD, pinentry or the Windows credentials dialog; SSH logins left to OpenSSH | | Packet types | Sends 6.5+ names; receives legacy unless XPRA_BACKWARDS_COMPATIBLE=0 | | Out-of-band chunks | Received and spliced back in by index | | Forwarded windows | Create / destroy / draw / move / resize / raise / minimize | | Advanced window state | Title, size constraints, raise and minimize/restore; no positioning or stacking on Wayland | | Override-redirect popups | X11, Windows, and Wayland xdg_popup | | Picture encodings | RGB24 and RGB32; PNG includes palette and grayscale | | Accelerated rendering | X11 pixmap backing store, GDI blits on Windows, wl_shm buffers on Wayland; no video acceleration | | Keyboard | X11 keysym names, the compositor's own keymap on Wayland, printable ASCII only on Windows; no keymap upload | | Pointer / input | Pointer, buttons, wheel and focus | | Server cursors | PNG only on all three backends, at the size the server sends; no cursor names, no scaling | | Window icons | PNG icons; on Wayland through xdg-toplevel-icon-v1, which the compositor is free to ignore | | Bell forwarding | Native X11 and Win32 sound; none on Wayland | | Desktop notifications | Logged only | | DPI / display sync | Windows per-monitor DPI awareness; nothing reported to the server | | Remote logging / events | Server lifecycle events and pings; no client-side remote logging | | Bandwidth adaptation | Pings only |

See also

Defunct clients

These clients are no longer maintained and will not work with the currently supported versions of the xpra server.
They are listed here for reference only:

| Client | Platform | Last activity | Notes | |--------------------------------------------------------------------------|---------------|---------------|-------------------------------------------------------------------------------------------------| | Android client | Android | 2015 | The original Java client, also shipped as part of winswitch - archived APKs from 2012 to 2015 | | Xpra-client-android | Android, Java | 2016 | Fork of xpra-client adding h264 decoding (GPLv3) | | xpra-client | Android, Java | 2021 | Java client with Android and Swing frontends (GPLv3) | | xpra-html5-client | Browser | 2024 | TypeScript / React rewrite of the html5 client, designed to be embeddable (MPL-2.0) |