GitXplorerGitXplorer
t

python-vnc-viewer

public
27 stars
22 forks
1 issues

Commits

List of commits on branch master.
Unverified
c4f4b6fe38c055bd04c0945fe1ca5ec74e1041ee

Update README.md

ttechtonik committed 9 years ago
Unverified
914b67477045acb08001a341f13674e7f6a1aa68

Update README.md

ttechtonik committed 9 years ago
Unverified
6b5e14ae808ba8868f9cdd6d0afb1a090b66d642

Update README.md

ttechtonik committed 9 years ago
Unverified
550c269deb965230f5bc1def1c976d2f161b495e

Update README.md

ttechtonik committed 9 years ago
Unverified
19cf148a836e6094dd6822ed9cf0184879b69a20

Update README.md

ttechtonik committed 9 years ago
Unverified
7bc58e9850db1c43cf4d4f13719862830889b561

Update and rename README.rst to README.md

ttechtonik committed 9 years ago

README

The README file for this repository.

Simple VNC viewer that is built with Twisted-Python and PyGame. Originally written by Chris Liechti.

The viewer supports the following encodings: Hextile, CoRRE, RRE, RAW, CopyRect

The display is done using pygame because of it's good graphics performance, but any GUI system can be used as the code is modular and can be easily adapted. Two good examples of code reuse are VNC client in browser by Arkaitz Jimenez, and most recent vncdotool by Marc Sibson. Pygame version supports clipboard transfer, but it's not used in the sample application.

Usage

You can simply start vncviewer.py and it will ask for a hostname and password if required. Hostnames are in the "host:display" form, where "display" is the VNC dispaly number.

These settings can be passed through command line, but note it's a bad idea to pass the password in this way as it can be snooped by other users with a simple process listing! Try -h or --help to see supported options.

Please keep in mind that VNC transimts keypresses in cleartext, so don't type in passwords on non-encrypted connection over insecure networks.

With "--depth" a display depth can be gived, use "8" for slower connections.

The "--fast" option uses only RAW and CopyRect encodings and is thus only suitable for fast connections. But it delivers better performance than other encodings.

What is it good for?

Nothing ;-) Use the original VNC viewer for better performance.

However it works very well and I think with a good speed. It could be embedded in other Python applications or it can server as a base of various supervision or remote desktop applications, automated tests of GUIs or be embedded in a tool for remote support...

Bugs, etc

  • Properties dialog is missing. Like for specifying encodings etc.
  • Listen mode not implemented.
  • Key repetition does not work (pygame?)
  • It does not reduce update requests when minimized.
  • Screen cannot be scolled, impractical if remote desktop is larger than local
  • The password dialog blocks twisted and everthing else

References:


Released under the MIT License.

You're free to use it for commercial and noncommercial application, modify and redistribute it as long as the copyright notices are intact. There are no warranties, not even that it does what it says to do ;-)

Changes:

2015.08.29 - expored to Github 2009.12.14 - 4. another update

  • replaced crippled_des.py with pyDes
  • TAB and BACKSPACE keys now work 2009.12.3 - 3. update
  • changed license to MIT with Chris consent as Python license is not supported by Google Code
  • works with twisted 8.2.0
  • works with pygame 1.9.1 (blit failed on locked surfaces)
  • don't refuse to connect to 3.7 and 3.8 VNC servers 2003.3.4 - 2. release
  • improved performance with RRE, CoRRE
  • color depth can be choosen (32, 8)
  • added "fast" option 2003.3.3 - 1. public release