xpra icon
Bug tracker and wiki

Version 21 (modified by Antoine Martin, 10 months ago) (diff)

move latest client link after default instructions

HTML5 Client

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=0.0.0.0:14500 --html=on --start=xterm
    

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

You can also access the latest version of the HTML5 client here: https://xpra.org/html5/connect.html

Source

The source can be found:

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=0.0.0.0:14500 --start=xterm --html=on \
    --auth=file --password-file=./password.txt

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

http://localhost:14500/index.html?username=test&password=123456

Encryption

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

AES

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:

PASSWORD=YOURPASSWORD
AES_KEY=0123456789ABCDEF
echo -n $PASSWORD > password.txt
echo -n $AES_KEY > aes.txt
xpra start :10 --bind-tcp=0.0.0.0:14500 --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"

Tickets

Features planned or in progress:

  • #1471 toolbar
  • #1463 html5 native video decoding support
  • #1359 webcam and microphone forwarding

Existing Features:

  • #1376 file upload support
  • #1484 - #1487 better language support
  • #1473 re-connection etc
  • #1491 more complete window management
  • #1520 mobile on-screen keyboard
  • #1461 clipboard synchronization
  • #1491 many updates (2.1 release)
  • #1424 faster network layer, input devices, etc
  • #1390 trackpad input device support
  • #845 sound support
  • #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

Issues: