This article describes how to invoke Jump Desktop from other applications on Android and iOS 3.x and above.
Jump Desktop can be launched from other applications using the jump:// url scheme. Arguments describing connection parameters are passed via POST parameters in the URL. For example:
jump://?param1=value1¶m2=value2
Each value must be properly escaped to make sure the URL is valid. You can customize all aspects of the connection using URL parameters. The following table lists a few basic parameters, but see the 'Advanced Customization' section below to learn how to control all aspects of the connection settings.
Parameter Meaning
| host | IP address or hostname of the host to connect to (192.168.1.1 or server.company.com). This is a required parameter. |
| protocol | Optional. Either rdp, fluid or vnc (if omitted this defaults to rdp) |
| port | Optional. The port to connect to (if omitted defaults to 3389 for rdp or 5900 for vnc) |
| password | Optional. The password to use for automatic login |
| depth | Optional. 8 for 8-bit color (256 colors), 16 for 16 bit color (if omitted defaults to 16bit for rdp and 8bit for vnc) |
The following parameters apply to RDP connections only:
| username | Optional. User name to use for automatic login |
| domain | Optional. Domain name to use for automatic login |
| width | Optional. Width of the display (if omitted defaults to 1024) |
| height | Optional. Height of the display (if omitted defaults to 768) |
| console | Optional. If set to yes , connects to the console session on Windows server machines |
Example URL usage:
1) Connect to host 192.168.1.100 using RDP:
jump://?host=192.168.1.100
2) Connect to host server.mydomain.com using RDP with user name 'testuser' and password 'pass':
jump://?host=server.mydomain.com&username=testuser&password=pass
Advanced Customization
Jump Desktop allows you to customize all aspects of the connection settings using URL parameters. Any setting present in the Jump JSON file format can be added to the URL parameters. For example if you want to customize the gesture profile to be multi-touch then use the following URL parameter:
GestureProfileCode=4
The full list of settings in the Jump JSON file format can be found here: Jump Desktop JSON File Format documentation page.
Comments
16 comments
In version including 3.6 the protocol variable in the url breaks the url and it doesn't attempt to make a connection
@Kevin - thanks for letting us know. We'll take a look into fixing this for 3.6.1.
Correction - the fix for this did _not_ make it into 3.6.1.
The VNC fix will be available in 4.0
hi, how can i hide the jump desktop icon from the taskbar??
can i still view mt computer( still use jump application on idevice) if i exit the application on my computer but still stay "online and connected"?
@Mbykers sorry about the delay in getting back to you: You can't hide the Jump Desktop icon from the taskbar. Yes, you'll still be connected if you exit the tray app though.
I using to get to all my server at different clients. We us n-able as our RMM product. This have the ability to use RDP but the default setup is to use the windows path. I want to setup it up to use Jump Desktop but I am unsure how I need to make this happen. I have attached a screenshot of the box that I need to fill in to make it work.
Thanks!
Rob
RemoteControl Launcher.png
@Rob try this:
Executable path: /usr/bin/open
Command Line Parameters: jump://IP:Port
Where "IP:Port" above should replaced by whatever RMM uses to substitute the IP address and port.
I use the jump:// url scheme from my Android app to connect via Jump Desktop. The connection works great, but when I run Jump like that and I open the task switcher, then I only see my app and not Jump. I cannot switch back to my app while Jump still runs. I have to disconnect and close Jump to get back.
Is this configurable or is it a bug?
Trying to use jump://<server name> and it's not working. Also tried jump://?host=<server name> as shown above and it's not working. I'm trying to connect to computers on my internal network and every time I try those URLs, I get a "Connection Refused." Message
the protocol=fluid function doesn't work for me at all
This page is very helpful (!) but I don't think it is complete. I don't see the parameters documented that would correspond to some of the settings I use in the Jump Desktop UI.
E.g. I log into a Linux server named [myhostname]@[mydomain.net] using VNC over SSH. In the UI I used the following configuration:
address:localhost:[vnc port #]
password=saved # unfortunately, I don't remember what that password is, but that's
# a different problem
quality=high
clipboard=[true]
keyboard=U.S. English
auth=vnc password
ssh tunnel=[vnc username]@[myhostname.mydomain.net]
...but it's not clear to me how I would spell that using the URL method to automate my logins. Most ideally, I'd like an in-app widget that would just dispay for me what that URL would be so I could just copy and paste it into my code.
This is an absolutely fabulous app, by the way.
MacOS Example that worked for me: open jump://?host=10.99.107.94\&port=5903\&protocol=vnc
I use this for VM's in GNS3 in place of Chicken of the VNC.
This is the line I use for Custom VNC options in GNS3
open jump://?host=%h\&port=%p\&protocol=vnc
when I use JumpDesktop v8.5.15
“open jump://?host=mypc&port=3389&username=myuser&password=mypass”
can open mypc direct
but use JumpDesktop v8.10.5
it prompt a login dialog，I must type my username and my password，it open mypc。
Pass username & password to url is no longer supported ？
Please sign in to leave a comment.