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.

Parameter	Format	Meaning
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:

Parameter	Format	Meaning
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:

Parameter	Format	Meaning
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:

Parameter	Format	Meaning
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.

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

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

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