Docs › Screens

Screens

The app's Screens tab shows and controls each machine's screen in the browser (noVNC), so you can check on a worker from a tablet. The app relays the connection from the hub; your tablet never connects to the workers directly.

Tell Sparehand each machine's VNC address:

• Workers: sparehand add NAME HOST --screen 192.168.1.20:5900, or the fifth column of ~/.config/sparehand/workers.
• The hub: SPAREHAND_HUB_SCREEN=127.0.0.1:5900 in ~/.config/sparehand/sparehand.conf.

Machines without a screen address don't appear in the tab.

macOS

System Settings → General → Sharing → Screen Sharing: on, and allow your user only. In the app you sign in with that Mac's username and password.

Windows

Windows' own Remote Desktop isn't VNC; install a VNC server such as TightVNC (service mode, VNC password on), and allow port 5900 from the hub only, both in the VNC server's access control and in Windows Firewall:

New-NetFirewallRule -DisplayName "VNC from the Sparehand hub" -Direction Inbound -Protocol TCP `
  -LocalPort 5900 -RemoteAddress 192.168.1.10 -Action Allow

The VNC password is limited to 8 characters by the protocol, which is why the hub-only rule matters. The viewer has a Ctrl+Alt+Del button for Windows machines.

Linux

Any VNC server works (x11vnc, wayvnc, TigerVNC); allow it from the hub only.