JDZ file format
The JDZ file or Jump Desktop Archive file is a regular zip file which contains "jump" files (see below for the jump file format). To view the contents of a .jdz file, rename the file extension to .zip and uncompress the contents of the zip file. Inside you'll see a servers directory which contains all the servers you exported in .jump file format. This includes your computers, SSH servers and RD Gateways.
.jump JSON file format
Jump Desktop stores computer configuration using a JSON file format. Each computer, SSH server and RD Gateway configuration is stored as a separate file using the JSON file format. This section describes keys and values for each type of configuration.
Computer Configuration
| Key | Type | Description |
|---|---|---|
| AudioPlaybackCode | integer | Controls how audio is redirected. 0 - don't play audio, 1 - play on remote server, 2 - play on local device. This is RDP only. |
| ClipboardRedirection | boolean | |
| ColorDepthCode | integer | the remote display's colour depth. 0 - 8 bit colour depth, 2 - 16 bit colour depth, 3 - 24 bit colour depth, 4 - black and white (VNC only), 5 - gray scale (VNC only) |
| ConnectionTypeCode | integer | must always be 0 for manual connections |
| Domain | string | the domain name to use when logging into the computer |
| DisableServerEdit | boolean | set to true to disable editing the server settings through Jump Desktop's UI - iOS only. See this link for more information. |
| DisplayName | string | the name of computer shown to the user in the UI |
| DriveMappings | array of drive mappings | RDP only. Each element in the array is a dictionary. See the Drive Mappings section below for details |
| GestureProfileCode | integer | The gesture profile to use when connected to a remote (iOS only). 0 - standard gesture, 2 - pen gesture, 3 - trackpad gestures, 4 - direct touch mode (Multitouch mode on Windows 8+ RDP or direct touch on other protocols) |
| HideMouseCircle | boolean | set to true to hide the mouse circle (iOS only) |
| HideMousePointer | boolean | set to true to hide the mouse pointer (iOS only) |
| IgnoreCertificateErrors | boolean | set to true to ignore SSL certificate certification errors (RDP only) |
| KeyboardAutomaticLocaleDetection | boolean | set to true to automatically select a remote keyboard that matches the local keyboard (RDP and Apple Remote Desktop only) |
| KeyboardLocaleId | integer | the integer value of the remote keyboard's locale id (RDP and Apple Remote Desktop only) |
| MacAddresses | array of strings | an array of strings where each string has 6 hexadecimal bytes with a space in-between them that specifies the remote computer's network MAC address. This can have multiple strings, each with a different MAC address. Jump uses the MAC address when sending WOL packets to the computer before attempting a connection |
| MatchScreenResolution | boolean | set to true match the local monitor's resolution - this makes Jump ignore the ResolutionWidth and ResolutionHeight fields |
| MonitorCount | integer between 1 | the number of monitors to show - this is RDP and Jump Desktop for iOS only |
| MouseCursorUpdates | boolean | set to true to make the local mouse pointer change to match the remote pointer (Jump Desktop for Mac only) |
| ProtocolTypeCode | integer | the protocol to use when connecting to the server. 0 - RDP, 1 - VNC |
| RDGatewayUniqueId | string | the unique id of the RD Gateway configuration to use when when connecting to a server. Set to null if a RD Gateway server should not be used |
| RdpAlternateShellPath | string | alternate shell path to use when connecting to a RDP server. This is RDP only. |
| RdpAlternateShellWorkingDir | string | alternate shell working directory to use when connecting to a RDP server |
| RdpConsoleSession | boolean | set to true to connect to the console or admin session (/admin or /console in mstsc). This is RDP only. |
| RdpDisableBitmapCaching | boolean | set to true to disable RDP bitmap caching (not recommended). This is RDP only. |
| RdpDisableNLA | boolean | set to true to disable RDP's NLA authentication. This is RDP only. |
| RdpDisableServerRedirection | boolen | set to true to ignore redirection packets sent from the server. This is RDP only. |
| RdpDriveRedirection | boolean | set to true to enable drive redirection. RDP and Jump Desktop for Mac only. |
| RdpPerformanceFlags | integer | RDP performance flags. This is a bit-field where the flags are OR'd together to create the final value. 0x01 - disables wallpaper, 0x02 - disables showing the contents of the window while dragging, 0x04 - disables menu animations, 0x08 - disables theming, 0x80 - enables font smoothing |
| RdpPrinterRedirection | boolean | set to true to advertise local printers to the RDP server |
| RdpUseUnicodeKeyboard | boolean | turns on 'compatibility mode' when sending key strokes to the RDP sever |
| ResolutionHeight | integer | the height of the remote display. This is RDP only. |
| ResolutionWidth | integer | the width of the remote display. This is RDP only. |
| SshServerUniqueId | string | the unique id of the SSH configuration to use when when connecting to the computer |
| SslCertificateFingerPrint | string - base64 encoded | The server's SSL certificate finger print. If Jump could not verify the server's SSL certificate, then |
| StartInFullscreen | boolean | Whether Jump should go full screen as soon as the connection is launched. This is only used on the Mac or Windows where there is a concept of application windows that can go fullscreen. This is implied on iPad / iPhone / Android. |
| ChangeResolution | boolean | True if Jump should change the remote computer's resolution to match the local device's resolution. This only applies to Fluid connections. This is implied for RDP connections where we always have to set the remote's resolution. |
| UseDynamicResolutionUpdate | boolean | True if the remote resolution will be dynamically updated as the local window is resized, or as the device orientation changes. Only applies to RDP on Windows 8+ or Fluid connections. |
| SwapMouseButtons | boolean | set to true to swap the left and right mouse buttons |
| Tags | array of strings | an array of user-defined tags for the computer. each string in the array is a single tag |
| TcpHostName | string | the hostname or IP address of the computer |
| TcpPort | integer | the port number of the computer's RDP or VNC server |
| TypeCode | integer | must always be 1 |
| UniqueId | string | a string that specifies a unique value for this connection - this must be unique across all computer, SSH and RD gateway connections |
| Username | string | the username to use when logging into the computer |
Example:
{
"AudioPlaybackCode": 0,
"ClipboardRedirection": true,
"ColorDepthCode": 3,
"ConnectionTypeCode": 0,
"DisableServerEdit": false,
"DisplayName": "My Computer",
"Domain": "domain",
"DriveMappings": [
{
"DisplayName": "Downloads",
"Enabled": true,
"IsReadOnly": false,
"LocalPath": "/Users/me/Downloads",
"UniqueId": "11A92900-35A4-412C-983D-EE276A2A824F"
}
],
"GestureProfileCode": 0,
"HideMouseCircle": false,
"HideMousePointer": false,
"IgnoreCertificateErrors": false,
"KeyboardAutomaticLocaleDetection": false,
"KeyboardLocaleId": 0,
"MacAddresses": [
"00 0C 29 5A C6 79"
],
"MatchScreenResolution": false,
"MonitorCount": 0,
"MouseCursorUpdates": true,
"ProtocolTypeCode": 1,
"RDGatewayUniqueId": null,
"RdpAlternateShellPath": "c:\path",
"RdpAlternateShellWorkingDir": null,
"RdpConsoleSession": false,
"RdpDisableBitmapCaching": false,
"RdpDisableNLA": false,
"RdpDisableServerRedirection": false,
"RdpDriveRedirection": false,
"RdpPerformanceFlags": 0,
"RdpPrinterRedirection": true,
"RdpUseUnicodeKeyboard": false,
"ResolutionHeight": 1024,
"ResolutionWidth": 768,
"SshServerUniqueId": null,
"SslCertificateFingerPrint": null,
"StartInFullscreen": false,
"SwapMouseButtons": false,
"Tags": [ "Tag1", "Tag2" ],
"TcpHostName": "test.jumpdesktop.com",
"TcpPort": 5907,
"TypeCode": 1,
"UniqueId": "0A28DB98-D30C-4DF9-9252-64B9F448F935",
"UseAllMonitors": false,
"UseTls": true,
"Username": "",
}
Drive mapping format keys
| Key | Type | Description |
|---|---|---|
| DisplayName | string | the display name to show in the UI for the drive mapping |
| Enabled | boolean | true if the mapping is enabled, false otherwise |
| IsReadOnly | boolean | true if the mapping is read only and can not be written to by the remote computer |
| LocalPath | string | the local path to map |
| UniqueId | string | unique id for this drive mapping |
Example with one drive mapping:
"DriveMappings": [
{
"DisplayName": "Downloads",
"Enabled": true,
"IsReadOnly": false,
"LocalPath": "/Users/me/Downloads",
"UniqueId": "11A92900-35A4-412C-983D-EE276A2A824F"
}
],
SSH Server Configuration
| Key | Type | Description |
|---|---|---|
| AuthenticationTypeCode | integer | type of authentication to use when connecting the SSH server. 0 - use password based authentication, 1 - use public key authentication |
| DisplayName | string | the display name of the server for UI |
| PrivateSshKeyPath | string | the private key path to use when connecting to the SSH server (only used if public key authentication is being used) |
| PublicKey | string | string with the bytes in hex of the SSH server's fingerprint |
| TcpHostName | string | hostname or IP address of the SSH server |
| TcpPort | integer | numeric port number of the SSH server |
| TypeCode | integer | type of connection this JSON file describes. Must always be 2 for SSH server connections |
| UniqueId | string | the unique id for this connection. This must be unique across all computer, SSH and RD gateway connections |
| Username | string | The username to use when logging into the SSH server |
Example:
{
"AuthenticationTypeCode": 1,
"DisplayName": "Jump SSH Server",
"PrivateSshKeyPath": "/Users/me/.ssh/id_rsa",
"PublicKey": "4F 03 F5 A3 C6 01 90 B4 18 15 CC 81 74 D7 7D A7",
"TcpHostName": "ssh.jumpdesktop.com",
"TcpPort": 22,
"TypeCode": 2,
"UniqueId": "BDDC643D-5635-4845-A3ED-B28E162AF196",
"Username": "myusername",
}
RD Gateway Configuration
| Key | Type | Description |
|---|---|---|
| DisplayName | string | the display name of the server - this for UI only |
| Domain | string | the domain name to use when logging into the RD gateway server. Set this to null if the computer connection's domain name should be used |
| Username | string | the username to use when logging into the RD gateway server. Set this null if the computer connection's username should be used |
| TcpHostName | string | hostname or IP address of the RD Gateway server |
| TcpPort | integer | numeric port number of RD Gateway server |
| TypeCode | integer | the type of connection this JSON file describe. Must always be 3 for RD Gateway connections |
| UniqueId | string | the unique id for this connection. This must be unique across all computer, SSH and RD gateway connections |
Example:
{
"DisplayName": "rd.jumpdesktop.com",
"Domain": "",
"Username": "administrator"
"TcpHostName": "rd.jumpdesktop.com",
"TcpPort": 443,
"TypeCode": 3,
"UniqueId": "DCB05FFC-ED71-4E83-A39F-74A50D42D2EE",
}
Comments
1 comment
What changes were made for Fluid Desktop?
Please sign in to leave a comment.