xpra icon
Bug tracker and wiki

This bug tracker and wiki are being discontinued
please use https://github.com/Xpra-org/xpra instead.

Version 16 (modified by Antoine Martin, 5 years ago) (diff)


HTML5 Client

You can access the current version of the HTML5 client here: http://xpra.org/html5/connect.html.

To setup your xpra server with HTML5 support:

  • you must have websockify installed
  • use both the bind-tcp=... and the html=on flags on the command line, ie:
    xpra start --bind-tcp= --html=on --start=xterm

You can then point your browser to http://localhost:14500/ and the xterm should appear in your browser window.

Password Authentication

You can use authentication by supplying the values on the URL.

Connecting to a server started with:

echo -n 123456 > ./password.txt
$ xpra start --bind-tcp= --start=xterm --html=on \
    --auth=file --password-file=./password.txt

As user test, you can then connect with the following URL:



The easiest and safest way to encrypt traffic is to use SSL (https / wss)


Alternative (no longer supported): the following commands will setup an HTML5 server with AES encryption and password authentication then launch a browser and connect to it:

echo -n $PASSWORD > password.txt
echo -n $AES_KEY > aes.txt
xpra start :10 --bind-tcp= --html=on --start=xterm \
    --auth=file --password-file=`pwd`/password.txt \
    --tcp-encryption=AES --tcp-encryption-keyfile=`pwd`/aes.txt
sleep 5
xdg-open "http://localhost:14500/index.html?username=$USER&password=$PASSWORD&encryption=AES&key=$AES_KEY"


Features planned or in progress:

  • #1491 many updates (2.1 release)
  • #1471 toolbar
  • #1424 faster network layer, input devices, etc
  • #1463 html5 native video decoding support
  • #1461 clipboard synchronization
  • #1390 trackpad input device support
  • #1359 webcam and microphone forwarding
  • #845 sound support

Existing Features:

  • #1341 many updates (1.0 release)
  • #1484 better keyboard layout support
  • #1432 paint scroll events
  • #1473 re-connection, event hooks, "steal" option
  • #1376 drag-n-drop upload, download files
  • #933 encryption
  • #913 printing
  • #858 numlock sync
  • #850 improvements: login page, etc
  • #842 clipboard support
  • #838 auto-connect
  • #689 html server built-in
  • #473 original html feature ticket
  • #474 port multiplexing