9f4af5a722
- Hextile has an undocumented weirdness where RAW frames are often followed by a 0 byte that should be ignored. - Coallesce client messages that are one after another. Without this the server seems to often ignore frames that are send right after another frame has been sent. This fixes a reconnect issue where setEncodings seems to be ignored. Also results in a huge performance increase after key strokes (by adding a update request to the key event message) because the server always sends an update instead of sometimes waiting for the next poll to be sent. |
||
|---|---|---|
| docs | ||
| include | ||
| README.md | ||
| canvas.html | ||
| canvas.js | ||
| prime.html | ||
| prime.js | ||
| rfb_notes | ||
| vnc.html | ||
| vnc.js | ||
| web.py | ||
| wsproxy.py | ||
README.md
VNC HTML5 Client
Description
An VNC client implemented using HTML5, specifically Canvas and Web Sockets.
Requirements
-
A browser that supports Web Sockets (mostly Chrome as of Apr 6, 2010) and Canvas (most browsers)
-
Until VNC server support web sockets, you need to use a Web Sockets to normal socket proxy. There are a couple reasons for this:
-
Web Sockets is not a pure socket protocol. There is an initial HTTP like handshake to allow easy hand-off by web servers and allow some origin policy exchange. Also, each Web Sockets frame begins with 0 ('\x00') and ends with 255 ('\xff').
-
Javascript itself does not have the ability to handle pure byte strings (Unicode encoding messes with it) even though you can read them with Web Sockets. The python proxy base64 encodes the data so that the Javascript client can base64 decode the data into an array.
-
Usage
-
run a VNC server.
Xvnc :1 -
run the python proxy:
./wsproxy.py [listen_port] [vnc_host] [vnc_port]./wsproxy.py 8787 localhost 5901 -
run the mini python web server to serve the directory:
./web.py PORT./web.py 8080 -
Point your web browser at http://localhost:8080/vnc.html (or whatever port you used above to run the web server).
-
Provide the host and port where the proxy is running and the password that the vnc server is using (if any).