jcarr
/
noVNC
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
VNC client web application
492 Commits 4 Branches 22 Tags 18 MiB
JavaScript 92.7%
CSS 3.8%
HTML 2.2%
Shell 1.1%
Makefile 0.2%
Go to file
Joel Martin aa67056785 Fix issue #102 - Opera 11.60 doesn't work. 
Opera presto engine version detection is broken. For now, just return
true or false. That should cover most cases.
 		2011-11-19 17:37:18 -06:00
debian debian/ - Update CSS file names. 2011-10-31 12:20:46 -05:00
docs LICENSE.txt, docs/TODO: bring up to date. 2011-09-28 11:39:36 -05:00
images Formatting. Image renames/cleanup. 2011-09-29 09:32:09 -05:00
include Fix issue #102 - Opera 11.60 doesn't work. 2011-11-19 17:37:18 -06:00
tests Make tests/vnc_perf.html work again. 2011-09-25 22:02:13 -05:00
utils websockify --run-once, --timeout, numpy fallback 2011-09-29 16:12:19 -05:00
.gitignore Ignore utils/rebind.so 2011-03-23 21:23:08 -05:00
LICENSE.txt Formatting. Image renames/cleanup. 2011-09-29 09:32:09 -05:00
README.md LibVNCServer capitalization. 2011-11-17 10:53:31 -06:00
favicon.ico Add logo, favicon. 2011-02-03 11:04:32 -06:00
vnc.html Formatting. Image renames/cleanup. 2011-09-29 09:32:09 -05:00
vnc_auto.html vnc_auto.html: sync with mobile changes. 2011-09-27 12:49:50 -05:00

README.md

noVNC: HTML5 VNC Client

Description

noVNC is a HTML5 VNC client that runs well in any modern browser including mobile browsers (iPhone/iPad and Android).

Notable commits, announcements and news are posted to @noVNC

There are many companies/projects that have integrated noVNC into their products including: Ganeti Web Manager, Archipel, openQRM, OpenNode, OpenStack, Broadway (HTML5 GDK/GTK+ backend), OpenNebula, CloudSigma, Zentyal (formerly eBox), SlapOS, Intel MeshCentral, Amahi, Brightbox, and LibVNCServer. See this wiki page for more info and links.

Features

  • Supports all modern browsers including mobile (iOS, Android)
  • Supported VNC encodings: raw, copyrect, rre, hextile, tightPNG
  • WebSocket SSL/TLS encryption (i.e. "wss://") support
  • 24-bit true color and 8 bit colour mapped
  • Supports desktop resize notification/pseudo-encoding
  • Local or remote cursor
  • Clipboard copy/paste
  • Clipping or scolling modes for large remote screens
  • Easy site integration and theming (3 example themes included)
  • Licensed under the LGPLv3

Screenshots

Running in Chrome before and after connecting:

 

See more screenshots here.

Browser Requirements

  • HTML5 Canvas (with createImageData): Chrome, Firefox 3.6+, iOS Safari, Opera 11+, Internet Explorer 9+, etc.

  • HTML5 WebSockets: For browsers that do not have builtin WebSockets support, the project includes web-socket-js, a WebSockets emulator using Adobe Flash. iOS 4.2+ has built-in WebSocket support.

  • Fast Javascript Engine: this is not strictly a requirement, but without a fast Javascript engine, noVNC might be painfully slow.

  • I maintain a more detailed browser compatibility list here.

Server Requirements

Unless you are using a VNC server with support for WebSockets connections (such as x11vnc/libvncserver), you need to use a WebSockets to TCP socket proxy. There is a python proxy included ('websockify').

Quick Start

  • Use the launch script to start a mini-webserver and the WebSockets proxy (websockify). The --vnc option is used to specify the location of a running VNC server:

    ./utils/launch.sh --vnc localhost:5901

  • Point your browser to the cut-and-paste URL that is output by the launch script. Enter a password if the VNC server has one configured. Hit the Connect button and enjoy!

Other Pages