willbprog127 / spiritvnc-fltk

A multi-view VNC viewer for Linux, FreeBSD, macOS and others

⚠️ NOTE: ⚠️ This project is currently deprecated and unmaintained in favor of SpiritVNC-FLTK-No-libssh2 due to issues with libssh2. Thanks! ⚠️

---

SpiritVNC - FLTK SpiritVNC - FLTK is an FLTK-based multi-view VNC client for Unix-like systems, including Linux, macOS and FreeBSD. SpiritVNC features VNC-through-SSH, reverse (listening) VNC connections and timed scanning of connected viewers.

(OpenIndiana was previously supported, but changes to their packages has caused some problems. Please contact me if you need SpiritVNC - FLTK working on OI)

2016-2021 Will Brokenbourgh https://www.pismotek.com/brainout/

To God be the glory! :-D ❤️

SpiritVNC - FLTK has a 3-Clause BSD License

---

Dependencies

You will need both the libraries and development packages of the following:

• fltk 1.3.4, 1.3.5 or newer
• libvncserver / libvncclient (if separate, you only need libvncclient)
• libssh2 (NOT libssh)

The 'pkg-config' program must be installed for building, unless you want to specify locations for includes and libs manually in the Makefile.

MacPorts is highly recommended for installing dependencies on macOS.

---

Building

SpiritVNC - FLTK now requires a compiler that supports C++11.

'cd' into the directory that has the Makefile, then...

On most Linux distros and macOS:

$ make [debug]
$ sudo make install   # (don't use this command when building on macOS)

On FreeBSD, OpenBSD and others:

$ gmake [debug]
$ sudo gmake install

---

Hey!

If you have an issue, need something tweaked or fixed, let me know. I have a busy schedule, but I want my software to work for you. Please file an Issue and I'll address it, one way or another. 😄

spiritvnc-fltk's Issues

Add (display) window icon

SpiritVNC comes with nice colorful spiritvnc.xpm but it's currently unused. I've ported the program to FreeBSD and added couple of lines to make use of the icon, perhaps you might want to merge some of those changes.

Sometimes multiple attempts are necessary to successfully connect

Sometimes you must double-click a connection several times in a row after the initial failure (usually 'Resource unavailable' or 'Incorrect password' even though the password is correct) to get it to connect.

This typically happens like this:

• Double-click connection
• Error icon immediately shows up and right-clicking item shows 'Resource unavailable or Incorrect password' even though the password is correct
• This pattern continues one or more times until finally the connection is successfully made

I have looked into this and still not certain why the error happens. It could be the way password string is handled by the password callback. It's possible it's being freed too earlier or some similar issue.

VNC over SSH connections may fail to connect

Issue
When attempting to connect to ssh servers from Cygwin and Windows 10 built-in SSH servers, the connection may never complete.

Proposed solution
libssh2 appears to be the problem. I am planning on removing it completely and SpiritVNC - FLTK will instead depend on the client system's SSH binary, if installed.