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 | 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.
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.
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.
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 |
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 |
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 |
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 |
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 |
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) |