Introduction

The ruby-vnc library provides for simple rfb-protocol based control of a VNC server. This can be used, eg, to automate applications (sometimes there is no better way), or script some sort of interaction.

Being VNC based gives it the advantage of being able to be run against servers on any platform.

The primary documentation is for the Net::VNC class.

Running the tests

• Boot up the two VNC servers with ‘docker-compose up`.

• Run the test-suite with ‘bundle exec rake spec`.

Resources

• The Remote Framebuffer Protocol (RFC6143)

• github.com/rfbproto/rfbproto/blob/master/rfbproto.rst

Thanks

Code borrows a lot from Tim Waugh’s excellent rfbplaymacro. So far all it really offers on top of that is access to the host clipboard, and the ease with which it can be scripted, ie taking conditional actions based on the contents thereof.

TODO

• Having the ability to take and analyse screen dumps would be useful.

• Finish the specs.

• Fix issues with the way we use a background thread to handle the clipboard etc chatter from the server.