Menu

Tree [21eca8] master /
 History

HTTPS access


File Date Author Commit
 doc 2010-08-20 Peter Rosin Peter Rosin [81f73c] Add --auto-reconnect option.
 lib 2010-10-15 Peter Rosin Peter Rosin [4fa820] Update the MIT license text to a more appropria...
 m4 2014-10-07 Peter Rosin Peter Rosin [21eca8] Sync with upstream.
 msi 2010-10-15 Peter Rosin Peter Rosin [4fa820] Update the MIT license text to a more appropria...
 src 2011-09-21 Peter Rosin Peter Rosin [7aed97] Adjust to further changes in widget palette han...
 .gitignore 2010-08-20 Peter Rosin Peter Rosin [c8a6c4] Convert to UNIX line endings.
 CHANGES 2010-08-20 Peter Rosin Peter Rosin [81f73c] Add --auto-reconnect option.
 COPYING 2010-10-15 Peter Rosin Peter Rosin [4fa820] Update the MIT license text to a more appropria...
 HACKING 2010-08-20 Peter Rosin Peter Rosin [a444fb] Remove libtool from the tree and rely on autore...
 Makefile.am 2010-11-12 Peter Rosin Peter Rosin [ff257e] Make the resource compiler output nicer when si...
 README 2009-09-15 Peter Rosin Peter Rosin [0e147a] Add support for the TRLE encoding.
 TODO 2009-09-30 Peter Rosin Peter Rosin [54acec] Reconnect popup/dialog is no longer a TODO item.
 configure.ac 2010-11-12 Peter Rosin Peter Rosin [e61163] Probe if the 2nd argument of the iconv function...
 ggivnc.ico 2007-04-24 Peter Rosin Peter Rosin [45f36b] Make the 'I' in the icon look less like a 't'.
 ggivnc_rc.in 2009-09-30 Peter Rosin Peter Rosin [b3511f] /* Switch to C style comments. */

Read Me

Introduction
------------

This is ggivnc, a VNC client using libraries from the GGI project to
draw and handle input.

The reason this VNC client came about was to fill the need for a
companion to the VNC target (display-vnc) in libggi. All existing VNC
code was at the time of writing and to the best of my knowledge GPL
and originating from the original AT&T code base (either that, or
hidden from sight). This VNC client is an implementation from scratch
featuring the following encodings:

Raw, CopyRect, RRE, CoRRE, Hextile, Tight, Zlib, ZlibHex, TRLE, ZRLE,
DesktopSize, LastRect, GII and DesktopName.

And the following security types:

None, VNC-auth, Tight and VeNCrypt.


Requirements
------------

ggivnc currently requires cvs-head versions of the GGI libraries (to be
3.0) and an as of yet unreleased version of the ggi-widgets library for
full functionality. Since the ggi-widgets library isn't stable yet, use
a version from about the same time as the ggivnc release you are trying
to build. ggivnc will get by with latest stable GGI libraries though
(i.e. version 2.x), but then you will not get dialogs nor scrollbars.
For full support of all the above encodings and security types ggivnc
will also use zlib, TurboJPEG (or libjpeg) and OpenSSL.

The AsciiDoc package is needed to build the documentation. If you don't
have AsciiDoc, the build will trap once for each type of documentation.
Just try again without installing AsciiDoc if you don't actually need to
build the documentation.


Source code
-----------

To get the latest version of ggivnc, the git repository can be cloned
with git like this:

git clone git://ggivnc.git.sourceforge.net/gitroot/ggivnc/ggivnc

You may also browse the repository:

http://ggivnc.git.sourceforge.net/git/gitweb.cgi?p=ggivnc/ggivnc


References
----------

GGI: http://www.ggi-project.org/
libjpeg: http://www.ijg.org/
OpenSSL: http://www.openssl.org/
TurboJPEG: http://sourceforge.net/projects/virtualgl/
zlib: http://www.zlib.net/
AsciiDoc: http://www.methods.co.nz/asciidoc/


Cheers,
Peter Rosin, original author