TheaView

Support

TheaView — VNC & RDP Remote Desktop Client

Frequently Asked Questions

How do I connect to a VNC server?

Click the + button in the toolbar, select VNC, enter the server address and port (default 5900), then click Connect. If the server requires authentication, you will be prompted for a password.

How do I connect to a Windows machine via RDP?

Add a new connection, select RDP as the protocol, and enter the hostname or IP address. Use your Windows username and password to authenticate. NLA (Network Level Authentication) is supported.

How do I set up an SSH tunnel?

In the connection settings, enable SSH Tunnel and enter your SSH server address, username, and select or generate an Ed25519 key. The tunnel is established automatically before connecting to the VNC server.

Do my connections sync across devices?

Yes. Saved connections and SSH keys sync via iCloud Keychain and CloudKit. Make sure you are signed into the same Apple ID on all your devices.

The connection drops or is very slow. What can I do?

Try switching to the Tight encoding with JPEG compression for slower networks. You can also lower the color depth in the connection settings. Auto-reconnect is enabled by default if the connection drops.

Is clipboard sharing supported?

Yes. Text clipboard is shared bidirectionally for both VNC and RDP. For RDP, file clipboard (drag & drop) is also supported.

What VNC encodings are supported?

TheaView supports Tight (JPEG & zlib), ZRLE, TRLE, Hextile, CopyRect, and Raw encodings. The client negotiates the best encoding automatically based on server capabilities.

Can I use TheaView on iPhone or iPad?

Yes. TheaView is available for iOS 18 and iPadOS 18 with full VNC and RDP support, including physical keyboard input on iPad.

How are my passwords stored?

All passwords and SSH keys are stored in the macOS or iOS Keychain, which is encrypted by the operating system. If iCloud Keychain is enabled, they sync securely across your devices via your Apple ID.

System Requirements

What are the minimum system requirements?

macOS 14 Sonoma or later on Mac (Apple Silicon and Intel). iOS 18 or iPadOS 18 on iPhone and iPad.

Troubleshooting

I get “Connection refused” when connecting

Make sure the VNC or RDP server is running on the remote machine, the port is correct (5900 for VNC, 3389 for RDP), and no firewall is blocking the connection. If you are using an SSH tunnel, verify that the SSH server is reachable.

The screen is black after connecting

Some VNC servers require a user to be logged in on the remote machine. Try logging in on the remote desktop first, or check that the VNC server is configured to share the active session.

Keyboard shortcuts are not forwarded

Make sure the session window is focused. Some system-level shortcuts (like Mission Control) are captured by macOS. You can use the Send Key menu in the toolbar to send specific key combinations to the remote machine.

Still need help?

Send us an email at support@pghsoftware.be and we will get back to you as soon as possible.