Skip to main content

a command line VNC client

Project description

With vncdotool you can interact with VNC servers from the command line

Currently under developement, so use at your own peril but what is the worst that could happen?

Quick Start

If you have a VNC server running you can quickly try out vncdotool by running:

python vncdotool/command.py -h hostaddr -d displaynum click 2

Which for most window managers will open a context menu at the top left corner of the screen. If you have PIL installed then you can do screen captures too:

python vncdotool/command.py -h hostaddr -d displaynum capture screen.png

Install

You will need to have Twisted installed, http://twistedmatrix.com. Optionally, you will also need the Python Imaging Library, http://www.pythonware.com/products/pil/. Once you have the dependencies installed you can install vncdotool from source with:

python setup.py install

Usage

Once installed you can use the vncdotool command to send keys, for alphanumeric you just specify the character. For other keys names are used:

vncdotool key a
vncdotool key 5
vncdotool key .
vncdotool key enter
vncdotool key shift-a
vncdotool key ctrl-C
vncdotool key ctrl-alt-del

To enter data you can use the type command, which only supports alphanumeric:

vncdotool type hello

You can also control the mouse pointer with move and click:

vncdotool move 100 100
vncdotool click 1

If you have the Python Imaging Library (PIL) installed you can also make screen captures of the session:

vncdotool capture screenshot.png

Again if you have PIL, you can wait for the screen to match a known image. This is useful for waiting for the server to be in a known state:

vncdotool expect somescreen.png 0

Finally, you may specify multiple actions on a single command line:

vncdotool type username key enter expect password_prompt.png
vncdotool type password move 100 150 click 1 expect welcome_screen.png

Feedback

Comments, suggestions and patches are welcome and appreciated. They can be sent to sibson+vncdotool@gmail.com or via http://github.com/sibson/vncdotool.

Acknowledgements

Thanks to chris, techtonik and Todd Whiteman for developing the RFB and DES impementations used by vncdotool.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

vncdotool-0.1.0.tar.gz (39.5 kB view details)

Uploaded Source

File details

Details for the file vncdotool-0.1.0.tar.gz.

File metadata

  • Download URL: vncdotool-0.1.0.tar.gz
  • Upload date:
  • Size: 39.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for vncdotool-0.1.0.tar.gz
Algorithm Hash digest
SHA256 a221d25588c4cce61eee10389df5f4c9c3f0ce07d4c53169303363174b3ea7be
MD5 4aaab41f16a258a222c5f2723a4989cf
BLAKE2b-256 1b200fb3d4e5fa9c41493f2b04d6dbba7fa3a7b5f400c7ff24b8cb2ed022e30d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page