Skip to content

VNC

VNC resources are opened using the built-in basic VNC client.

Configuration

FieldDescription
NameResource display name
HostVNC server address
PortDefault 5901
PasswordVNC password

Traditional VNC password auth does not have a username, so OmniGate's VNC resource does not configure a username.

If the server requires a password and the resource does not have a saved password, a password input dialog will appear when opening.

Display

The VNC screen scales to fit the screen proportion. Pinch-to-zoom is supported; when zoomed in, the view moves centered on the mouse position as much as possible.

In landscape mode, the navigation bar is hidden and a draggable real-time speed floating panel is displayed. A close button is on the right side of the floating panel.

Input

VNC supports touch and software keyboard:

  • Short tap without movement: Single click.
  • Swipe: Move mouse without clicking.
  • Double-tap, hold the second tap, and move: Drag.
  • Two-finger tap: Right click.
  • Two-finger vertical swipe: Simulates mouse scroll wheel. Swiping up corresponds to scrolling down.
  • In portrait mode, the software keyboard and common Windows shortcuts are available.

Two-finger gestures are prioritized as scroll. Zoom requires a distinct pinch gesture to trigger, preventing accidental zoom during swipes.

On macOS, trackpad scroll gestures are recognized as mouse wheel scrolling, providing an experience consistent with desktop VNC clients.

Shortcuts include Ctrl, Alt, arrow keys, PageUp, PageDown, Home, End, and F1-F12. Ctrl and Alt are sticky states used for sending keyboard combinations.

Auto-Reconnect

When a VNC connection is unexpectedly disconnected (for example, due to network fluctuation), OmniGate will automatically attempt to reconnect once.

Auto-reconnect will not occur in the following cases:

  • The user manually exits the VNC page.
  • The server returns a permanent error such as explicit authentication failure or connection refusal.

During auto-reconnect, the navigation bar displays a "Reconnecting" message. If reconnection also fails, you need to manually go back to the resource list and reopen the resource.

Known Limitations

Different VNC servers, resolutions, HiDPI settings, and mouse modes can affect pointer coordinate consistency. OmniGate displays a small black dot at the local mouse position to help you judge the relationship between local touch position and remote pointer position.

The current built-in VNC client is basic. Complex encoding, clipboard synchronization, and advanced graphics optimization may not be fully supported.

OmniGate User Manual