URI Scheme & Shortcuts

AVNC supports Android App Shortcuts and deep linking via the vnc:// URI scheme. This allows tasker apps, NFC tags, or external browsers to launch AVNC and connect automatically.

vnc:// URI Format

vnc://[host]:[port]/?param1=value1&param2=value2

If the host is an IPv6 address, it must be wrapped in square brackets (e.g., vnc://[fe80::1]:5900/).

Supported Query Parameters

  • ConnectionName: The label for the server. If this name matches an already saved profile in the database, AVNC will merge the URI parameters with the existing profile settings.
  • SaveConnection: (true / false) If set to true, AVNC will silently save this connection profile to the database after launching.
  • VncUsername: Username (Used primarily for VeNCrypt or Apple Remote Desktop).
  • VncPassword: The VNC connection password.
  • SecurityType: Integer representing the RFB security type:
  • 1 = None
  • 2 = VncAuth
  • 18 = TLS
  • 19 = VeNCrypt
  • 30 = Apple/macOS
  • ChannelType: Set to 24 to route the connection through an SSH Tunnel. Omit or set to 1 for direct TCP.
  • ViewOnly: (true / false) Starts the session with all inputs disabled.

SSH Specific Parameters

If ChannelType=24 is specified, you must provide SSH details:

  • SshHost: Hostname or IP of the SSH jump server.
  • SshPort: Port of the SSH server.
  • SshUsername: SSH username.
  • SshPassword: SSH password. (Note: Security restrictions prevent parsing private RSA/PEM keys via URIs).

Examples

Standard Direct Connection: 

vnc://192.168.1.100:5901/?VncPassword=MySecret&ViewOnly=true

Connecting via SSH Tunnel: 

vnc://10.0.0.5:5900/?ChannelType=24&SshHost=bastion.example.com&SshPort=2222&SshUsername=admin

App Shortcuts

AVNC utilizes the ShortcutManagerCompat API. The application maintains a useCount metric for every saved ServerProfile. When you long-press the AVNC icon on your Android home screen, the OS will display quick-launch shortcuts for your most frequently accessed servers, bypassing the Home screen entirely.