Skip to content

Latest commit

 

History

History
45 lines (36 loc) · 1.32 KB

README.md

File metadata and controls

45 lines (36 loc) · 1.32 KB

vnc_launcher

A wrapper around xvncviewer and it's kin to handle RFC-7869 style URIs

vnc_launcher will will process a vnc:// style URI, and launch a vnc-client based upon it. Notably, it will handle login credentials in the URI, a feature lacking in many VNC clients.

The VNC protocol itself doesn't have a username, if vnc_launcher encounters a username in the URI it will be ignored.

Requirements

Installing

cp vnc_launcher /somewhere/in/your/path
chmod a+x /somewhere/in/your/path

If you're missing the PyCrypto library run

pip install pycrypto

Most modern desktop environments can be configured for automatic handling of the VNC protocol by running the commands below.

cp vnc_launcher.desktop ~/.local/share/applications
update-desktop-database ~/.local/share/applications
xdg-mime default vnc_launcher.desktop x-scheme-handler/vnc

# Thanks
Thanks to James Cuzella, and his vncpasswd.py project which provided insight
into the password encoding mechanism used here.

Bugs

Probably.

References

Copyright (c) 2018 Stephen Kacsmark