We use cookies to improve your site experience. By using our websites you consent to this in accordance with the cookie section in our Privacy policy.
Accept
We use cookies to improve your site experience. By using our websites you consent to this in accordance with the cookie section in our Privacy policy.
Accept

About URL syntax and *.vncloc files

Remotix can open links starting with vnc://, rdp:// and remotix://. If you’re using remotix:// scheme, you have to specify the connection type using “type” parameter.

It is possible to combine all connection parameters into one valid link that can be opened by Remotix. The syntax is:

remotix://servername:port/?parameter1=value&parameter2=value

E.g. if you have Screen Sharing enabled on your MacBook, with user Martha that has password ohMyMac!, using this link will allow you to connect there immediately:

remotix://MacBook.local.:5900/?type=vnc&appleUsername=Martha&applePassword=ohMyMac!

Here is a list of parameters common to VNC or RDP connections.

Note: Percent-encoding is used for all strings. For more information on URL notation, see Percent-encoding.

ParameterFormatMeaning

serverName

Host name (server.domain.com), or IP address (xxx.xxx.xxx.xxx)

Server address

port

Number in range from 0 to 65535

Port number for VNC or RDP connections.
VNC default is 5900 and RDP default is 3389.

type

“rdp”, “vnc” or “near”

Connection type. Specify it for remotix:// links.
Apple Screen Sharing is counted as VNC type.

sshTunnelHost

Host name (server.domain.com), or IP address (xxx.xxx.xxx.xxx).
Might be the same as the serverName.

Address of server that will perform SSH tunneling

sshTunnelPort

Number in range from 0 to 65535

Port number for SSH tunneling. Default is 22.

sshTunnelUsername

Case-sensitive string

The username that you would use to login via SSH

sshTunnelPassword

Case-sensitive string

Corresponding SSH password

NEAR specific parameters:

ParameterFormatMeaning

quality

“smooth”, “balanced” or “sharp”

Image quality setting to be used when connecting

username

Case-sensitive string

Username you would use to log in to remote OS

password

Case-sensitive string

Matching password for the username above

Apple Screen Sharing and VNC specific parameters:

ParameterFormatMeaning

appleUsername

Case-sensitive string

macOS user login

applePassword

Case-sensitive string

macOS user password

ultraUsername

Case-sensitive string

Windows user login (UltraVNC)

ultraPassword

Case-sensitive string

Windows user password (UltraVNC)

unixUsername

Case-sensitive string

Unix user login (VeNCrypt TLS)

unixPassword

Case-sensitive string

Unix user password (VeNCrypt TLS)

Allowed RDP parameters:

ParameterFormatMeaning

serverName

Hostname (MacBook.local.), or IP address (xxx.xxx.xxx.xxx)

RDP server address

port

Number in range from 0 to 65535

Port number for RDP connection

rdpUsername

Case-insensitive string

Windows user login for RDP

rdpPassword

Case-insensitive string

Windows user password for RDP

rdpDomain

Case-insensitive string

Windows domain name

rdgUsername

Case-insensitive string

RD gateway user login

rdgPassword

Case-insensitive string

RD gateway user password

rdgDomain

Case-insensitive string

RD gateway domain

rdpDesktopWidth

Number

Predefined remote desktop width

rdpDesktopHeight

Number

Predefined remote desktop height

You can also connect to one of the stored servers via the link:

remotix://stored/?byName=connectionname, where connectionname stands for the name of the server in Remotix Stored list.

E.g. if you have a stored server named “Mom’s PC”, you can connect there by following this: remotix://stored/?byName=Mom%27s%20PC.

If you want to connect with other credentials, you may include them in the link using a similar template:

remotix://stored/?byName=<servername>[&vncPassword=][&appleUsername=][&applePassword=][&ultraUsername=][&ultraPassword=][&sshTunnelPassword=]

After a successful connection, the stored server preferences will be updated with the parameters passed in the link.

To connect to Remotix Cloud machines, use <Computer ID>.remotixcloud.com as a hostname. An access code may also be passed through the link: remotix://100500.remotix.com/?type=near&accessCode=IM1337.

Remotix can also establish connections described in *.vncloc files. These are usually created by Screen Sharing.app (the default macOS VNC client) and contain information that can be used to connect to the remote server.


  1. In the file’s context menu choose Open With.
  2. Select Remotix.

You can also assign Remotix as a default program to open *.vncloc files on macOS:


  1. In the file’s context menu, choose Get Info.
  2. In the appeared window expand section “Open with:”.
  3. Select Remotix in the dropdown list.
  4. Click Change all... to open the confirmation dialog.
  5. Click Continue.