Skip to content

Launch links and connection files#

jump:// links and .jump files open a Jump Desktop connection from outside the app, such as from a script, a shortcut, or another application. .jdz archives bundle .jump files for exporting saved computers and importing them on another device. This reference lists client support for each format and every parameter and key, for administrators and power users who create these links and files.

Client support#

Format macOS iPhone and iPad Windows
Open a jump:// link to connect Yes Yes Yes
Open an rdp:// or vnc:// link to connect Yes Yes No
Save a link as a computer (Import > From URL...) Yes Yes Yes
Open a .jump file to connect Yes No Yes (Open with)
Import a .jdz archive Yes Yes Yes
Export computers to a .jdz archive Yes Yes Yes

If jump:// links do not open on Windows, start Jump Desktop once to register the link handler.

Jump Desktop for Android Beta does not open launch links, .jump files, or .jdz archives. To start a connection from the Android home screen instead, touch and hold the computer in the computer list, then tap Add to Home screen. This option appears only when your launcher supports shortcuts.

jump://?host=<address>&<parameter>=<value>&...

URL-encode every value. Parameter names are case-sensitive.

Parameter Values Notes
host Hostname or IP address, optionally host:port Required.
protocol rdp, vnc Defaults to rdp.
port 1–65535 Defaults to 3389 for RDP and 5900 for VNC.
title Text Display name for the connection. Defaults to the host value.
username User name, or DOMAIN\user
domain Domain name
password Password Used for that session only; never saved. See the warning below.
console true, false RDP. Connect to the console session.
width, height Pixels RDP. Fixed remote resolution.
matchScreenResolution true, false Match the local display resolution.
depth 8, 15, 16, 24, 32, gray, bw Color depth. gray and bw apply to VNC.
gestureprofile default, locked, pen, trackpad, direct iPhone and iPad. Touch gesture profile.
hidemousecircle true, false iPhone and iPad.
hidemousepointer true, false iPhone and iPad.

Use true or false for boolean values. Unknown parameters are ignored. .jump file keys such as RdpPrinterRedirection do not work in links.

Passwords in links

Links are plain text and may be recorded in browser history, shell history, logs, and shortcuts. Do not include passwords in links you store or share.

Examples:

jump://?host=192.0.2.10
jump://?host=rdp.example.com&username=EXAMPLE%5Cjdoe&width=1920&height=1080
jump://?host=192.0.2.20&protocol=vnc&title=Lab%20Mac

To open a link from a script:

start "" "jump://?host=192.0.2.10"

open 'jump://?host=192.0.2.10'

Do not construct Fluid links manually. Instead, use Connect using app in the Teams dashboard, or Copy Launch URL in Connect for Cloudless Fluid.

To route a Cloudless Fluid connection's UDP session traffic through a gateway, add the gatewayudp parameter; see Connect through a gateway.

To have Jump Desktop retrieve the host's sign-in credentials from your own HTTPS service, add the credhost and credtoken parameters to a Fluid link; see Credentials Provider Alpha. This requires Jump Desktop 10.16 or later.

.jump files#

A .jump file is a JSON object that describes one computer. On macOS, opening the file starts the connection. On Windows, .jump files are not associated with Jump Desktop; to open one, right-click the file, choose Open with, and select Jump Desktop.

Key Type Values
TypeCode integer Required. 1 for a computer.
UniqueId string Unique ID, such as a UUID. Generated if missing. On macOS, an ID matching a saved computer opens that computer.
DisplayName string Display name in Jump Desktop.
ProtocolTypeCode integer 0 RDP, 1 VNC.
ConnectionTypeCode integer 0 for a manual (hostname) connection.
TcpHostName string Hostname or IP address.
TcpPort integer Port.
Domain string Domain for sign-in.
Password string macOS, iPhone and iPad. Used for the connection; never saved. Ignored on Windows.
ResolutionWidth, ResolutionHeight integer RDP remote resolution.
MatchScreenResolution boolean Match the local display resolution.
StartInFullscreen boolean Open in full screen (macOS and Windows).
ClipboardRedirection boolean Share the clipboard.
RdpConsoleSession boolean RDP. Connect to the console session.
RdpPrinterRedirection boolean RDP. Share local printers.
Tags array of strings Tags for the computer.

User names in .jump files are ignored.

Passwords in files

.jump files are plain text. Do not include passwords in files you store or share.

{
  "TypeCode": 1,
  "UniqueId": "0A28DB98-D30C-4DF9-9252-64B9F448F935",
  "DisplayName": "Office PC",
  "ProtocolTypeCode": 0,
  "ConnectionTypeCode": 0,
  "TcpHostName": "rdp.example.com",
  "TcpPort": 3389,
  "ResolutionWidth": 1920,
  "ResolutionHeight": 1080,
  "StartInFullscreen": true,
  "Tags": ["Office"]
}

.jdz archives#

A .jdz file is a ZIP archive of .jump files. To create one:

  • Windows: select computers in the computer list, right-click, and choose Export....
  • macOS: choose File > Export..., or right-click selected computers and choose Export....
  • iPhone and iPad: use Export All Computers in Settings.

On macOS, iPhone, and iPad, an export also includes the SSH tunnel and RD Gateway settings used by the exported computers.

To import an archive, open it, or use Import > From File.... To inspect or edit an archive, rename it to .zip and extract it.