It is possible to combine all VNC server’s parameters into one valid link that can be opened by Remotix. The syntax is:
remotix://servername:port/?parameter1=value¶meter2=value
E.g. if you have Screen Sharing enabled on your MacBook, where there is a user Martha with 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. |
type |
“rdp” or “vnc” |
Connection type. Specify it for remotix:// links. |
sshTunnelHost |
Host name (server.domain.com), or IP address (xxx.xxx.xxx.xxx). |
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 |
Apple Screen Sharing and VNC specific parameters:
Parameter | Format | Meaning |
---|---|---|
vncPassword |
Case-sensitive string |
8-character VNC password |
appleUsername |
Case-sensitive string |
OS X user login |
applePassword |
Case-sensitive string |
OS X 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 |
Host name (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 another credentials, you may include them into the link using the 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 <Remotix Cloud machine ID>.remotixcloud.com as a host name. An access code may also be passed through the link: remotix://100500.remotixcloud.com/?type=vnc&accessCode=1337.
Remotix can also connect to the servers described by *.vncloc files. These files are usually created by Screen Sharing.app (the default OS X VNC client), and they contain information which can be used to connect to the remote server.
You can also assign Remotix as a default program to open *.vncloc files.