diff --git a/README.md b/README.md index ff8ddda..9bdb1ea 100644 --- a/README.md +++ b/README.md @@ -8,10 +8,6 @@ specifically Canvas and WebSockets (supports 'wss://' encryption). noVNC is licensed under the [LGPLv3](http://www.gnu.org/licenses/lgpl.html). -For browsers that do not have builtin WebSockets support, the project -includes [web-socket-js](http://github.com/gimite/web-socket-js), -a WebSockets emulator using Adobe Flash . - Special thanks to [Sentry Data Systems](http://www.sentryds.com) for sponsoring ongoing development of this project (and for employing me). @@ -28,7 +24,26 @@ Running in Chrome before and after connecting: See more screenshots here. -### Requirements +### Browser Requirements + + +Detailed browser status/testing. + +* HTML5 Canvas: Except for Internet Explorer, most + browsers have had Canvas support for quite some time. Internet + Explorer 9 will have Canvas support (finally). + +* HTML5 WebSockets: For browsers that do not have builtin + WebSockets support, the project includes + web-socket-js, + a WebSockets emulator using Adobe Flash. + +* Fast Javascript Engine: noVNC avoids using new Javascript + functionality so it will run on older browsers, but decode and + rendering happen in Javascript, so a slow Javascript engine will + mean noVNC is painfully slow. + +### Server Requirements Unless you are using a VNC server with support for WebSockets connections (only my [fork of libvncserver](http://github.com/kanaka/libvncserver) @@ -116,77 +131,6 @@ There a few reasons why a proxy is required: vnc server is using (if any). Hit the Connect button. -### Browser Support - -In the following table Jaunty is Ubuntu 9.04 and WinXP is Windows XP. - -#### Linux (Ubuntu 9.04) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
OS BrowserStatusNotes
Jaunty Chrome 5.0.375.29ExcellentVery fast. Native WebSockets.
Jaunty Firefox 3.5GoodLarge full-color images are somewhat slow from web-socket-js overhead.
Jaunty Firefox 3.0.17FairWorks fine but is slow.
Jaunty Opera 10.60Poorweb-socket-js problems, mouse/keyboard issues. See note 1
Jaunty Arora 0.5GoodBroken putImageData so large full-color images - are slow. Uses web-socket-js.
Jaunty Konqueror 4.2.2Brokenweb-socket-js never loads
WinXP Chrome 5.0.375.99ExcellentVery fast. Native WebSockets.
WinXP Firefox 3.0.19GoodSome overhead from web-socket-js.
WinXP Safari 5.0FairFast. Native WebSockets. Broken 'wss://' (SSL) - weird client header
WinXP IE 6, 7, 8Non-starterNo basic Canvas support. Javascript painfully slow.
- - -* Note 1: Opera interacts poorly with web-socket-js. After two - disconnects the browser tab or Flash often hang. Although Javascript - is faster than Firefox 3.5, the high variability of web-socket-js - performance results in overall performance being lower. Middle mouse - clicks and keyboard events need some work to work properly under - Opera. Also, Opera does not have support for setting the cursor - style url to a data URI scheme, so cursor pseudo-encoding is - disabled. - - ### Integration The client is designed to be easily integrated with existing web diff --git a/docs/browsers.md b/docs/browsers.md index 8831a44..3cc186c 100644 --- a/docs/browsers.md +++ b/docs/browsers.md @@ -6,7 +6,7 @@ Browser Status - Notes + Performance/Notes Chrome 7.0.510.0 Broken @@ -23,14 +23,14 @@ Firefox 3.6.1 Good Slowed by web-socket-js overhead. Local cursor causes segfault. + + Arora 0.10.1 + Fair + Slow due to broken putImageData and web-socket-js. Opera 10.60 Poor web-socket-js problems, mouse/keyboard issues (see note 1) - - Arora 0.10.1 - Good - Slow due to broken putImageData and web-socket-js. Konqueror 4.3.2 Broken @@ -45,7 +45,7 @@ Browser Status - Notes + Performance/Notes Chrome 5.0.375.29 Excellent @@ -58,14 +58,14 @@ Firefox 3.0.17 Fair Works fine but is slow. + + Arora 0.5 + Fair + Slow due to broken putImageData and web-socket-js. Opera 10.60 Poor web-socket-js problems, mouse/keyboard issues (see note 1) - - Arora 0.5 - Good - Slow due to broken putImageData and web-socket-js. Konqueror 4.2.2 Broken @@ -80,19 +80,19 @@ Browser Status - Notes + Performance/Notes Chrome 5.0.375.99 Excellent Very fast. Native WebSockets. + + Safari 5.0 + Excellent + Fast. Native WebSockets. Firefox 3.0.19 Good Some overhead from web-socket-js. - - Safari 5.0 - Fair - Fast. Native WebSockets. IE 6, 7, 8 Non-starter