Skip to content

Launch links and connection files

jump:// links and .jump files open a connection in Jump Desktop from outside the app, such as from a script, a shortcut, or another application. .jdz archives bundle .jump files so you can export saved computers and import them on another device. This page is the reference for administrators and power users who create them: which clients support each format, and every parameter and key.

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

If jump:// links don't open on Windows, start Jump Desktop once to register the link handler.

Jump Desktop for Android doesn't 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 Name shown for the connection. Defaults to the host.
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 are for 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 don't work in links.

Passwords in links

Links are plain text and can end up in browser history, shell history, logs, and shortcuts. Don't put 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

Open a link from a script:

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

open 'jump://?host=192.0.2.10'

Don't build Fluid links by hand. Use Connect using app in the Teams dashboard, or Connect's Copy Launch URL for Cloudless Fluid.

.jump files

A .jump file is a JSON object describing one computer. On macOS, opening it starts the connection. On Windows, .jump files aren't associated with Jump Desktop: right-click the file, choose Open with, and pick 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, a match with a saved computer opens that computer.
DisplayName string Name shown 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. Don't put 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. Create one with Export... on macOS or Export All Computers in Settings on iPhone and iPad. To import one, open it, or use Import > From File.... To inspect or edit it, rename it to .zip and extract it. An export also includes the SSH tunnel and RD Gateway settings the exported computers use.