Keyboard and mouse profiles#
A keyboard and mouse profile is a named set of settings controlling how Jump Desktop for Windows and Jump Desktop for Mac handle keyboard and mouse input in a session. A profile contains key conversions, Jump Desktop shortcuts, system shortcuts, and mouse shortcuts. Because Windows and Mac shortcuts differ, the appropriate profile lets you use familiar shortcuts on either computer.
For example:
- On a Mac connected to a Windows host, press Cmd+C and Cmd+V to copy and paste, and Cmd+Q to close the remote app.
- Send Cmd+W and Cmd+Q to a Mac host instead of closing Jump Desktop.
- Assign one host its own profile, such as a host on which you want Jump Desktop shortcuts turned off entirely.
Applies to#
- Jump Desktop on Windows and macOS. On iPhone, iPad, and Android, see Use the keyboard.
- Every connection type. In Jump Desktop for Windows, choosing a profile for a specific computer is available only for computers that connect with Jump Desktop Connect (Fluid).
What a profile contains#
Profile settings have three tabs:
| Tab | Controls |
|---|---|
| Key Conversions | Key combinations converted before they are sent, and Defer Modifiers. |
| Keyboard Shortcuts | Jump Desktop shortcuts, and whether system shortcuts go to the host. |
| Mouse & Gestures | Mouse shortcuts for right click, middle click, scrolling, and zoom. |
Each app includes two built-in profiles, and you can add your own:
| Jump Desktop on | Built-in profiles |
|---|---|
| Windows | Windows and macOS |
| macOS | Windows and Mac |
Open profile settings#
- In the main window, choose File > Settings (Ctrl+,).
- Click Keyboard & Mouse.
- In When connecting to, choose the profile to view or edit.
- Press Cmd+, (comma) to open settings.
- Click Keyboard & Mouse.
- In When connecting to, choose the profile to view or edit.
When connecting to selects the profile to edit, not the profile a computer uses; see Choose the profile a computer uses.
Changes to key conversions apply to open sessions right away.
Key conversions#
A key conversion is a mapping that sends the host a different key combination than the one you press; for example, Ctrl+C when you press Cmd+C. The built-in profiles already include common conversions (see the defaults below). Configure conversions on the Key Conversions tab.
- Enable Key Conversions turns all of the profile's conversions on or off.
- Each conversion has its own checkbox, so you can turn off a single conversion without deleting it.
- A Jump Desktop shortcut that uses the same combination takes priority over a conversion.
Add or change a conversion#
- Click Add, or double-click a conversion to change it.
- Under When I press:, click the modifiers to include (Shift, Control, Alt, Win), then type a key or choose one from the list, such as Home, Esc, or F5.
- Under Send:, set the modifiers and key to send.
- Click OK.
To convert only the left or right modifier, such as Left Control, select Show Individual Modifiers, click the modifier under When I press:, and choose a side. The host always receives the left-hand modifier.
To delete a conversion, select it and click Delete. There is no confirmation prompt.
- Click +, or double-click a conversion to change it.
- In Edit Key Mapping, next to From:, click the modifiers to include (Shift, Control, Alt / Option, Cmd), then type a key in the box or choose one from the list, such as Home, Esc, or F5.
- Next to To:, set the modifiers (Cmd / Win sends Cmd to a Mac and Win to other computers) and key to send.
- Click OK.
Modifiers match either the left or right key.
To delete a conversion, select it and click −. There is no confirmation prompt.
To convert a modifier on its own, leave the key empty. When a conversion sends Alt+Tab, Cmd+Tab, or Win+Tab, the sent modifier remains held while you hold yours, so you can press Tab repeatedly to cycle through windows.
Defer Modifiers is a key conversion option that briefly holds back Alt and Win presses (Option and Cmd on a Mac) before sending them. It takes effect only while Enable Key Conversions is on. It is on by default in the Windows profile, and off in the macOS (Windows app) and Mac (Mac app) profiles.
To verify a conversion, connect and press the combination; the host should respond to the combination in Send: or To:.
Default conversions in Jump Desktop for Windows#
Windows profile, used for computers that are not Macs:
| You press | Host receives |
|---|---|
| Ctrl+Alt+End | Ctrl+Alt+Delete |
| Alt+Home | Ctrl+Esc (Start menu) |
| Ctrl+Alt+Tab | Alt+Tab |
| Ctrl+Alt+Left Arrow | Ctrl+Win+Left Arrow (previous virtual desktop). Works only if Toggle Windows Shortcuts is off; see Limitations. |
| Ctrl+Alt+Right Arrow | Ctrl+Win+Right Arrow (next virtual desktop) |
macOS profile, used for Mac computers:
| You press | Mac host receives |
|---|---|
| Left Ctrl | Cmd, so Ctrl+C, Ctrl+V, Ctrl+Z, and so on become Cmd shortcuts |
| Ctrl+Tab, Ctrl+Shift+Tab | Ctrl+Tab, Ctrl+Shift+Tab (unchanged, for switching tabs) |
| Ctrl+Alt+Tab | Cmd+Tab (switch apps) |
| Alt+Left Arrow, Alt+Right Arrow | Cmd+Left Arrow, Cmd+Right Arrow |
| Alt+F4 | Cmd+Q (quit app) |
| Ctrl+F4 | Cmd+W (close window) |
| Ctrl+Y | Shift+Cmd+Z (redo) |
| Ctrl+Win+F | Ctrl+Cmd+F (full screen) |
| Ctrl+Left Arrow, Ctrl+Right Arrow | Ctrl+Left Arrow, Ctrl+Right Arrow (unchanged, for switching Spaces) |
| Ctrl+Alt+Left Arrow, Ctrl+Alt+Right Arrow | Ctrl+Left Arrow, Ctrl+Right Arrow (switch Spaces). Ctrl+Alt+Left Arrow works only if Toggle Windows Shortcuts is off; see Limitations. |
Default conversions in Jump Desktop for Mac#
Windows profile, used for computers that are not Macs:
| You press | Host receives |
|---|---|
| Cmd+C, Cmd+X, Cmd+V, Cmd+A, Cmd+Z | Ctrl+C, Ctrl+X, Ctrl+V, Ctrl+A, Ctrl+Z |
| Cmd+S, Cmd+P, Cmd+F, Cmd+T | Ctrl+S, Ctrl+P, Ctrl+F, Ctrl+T |
| Shift+Cmd+Z | Ctrl+Y (redo) |
| Cmd+Q | Alt+F4 |
| Cmd+[ | Alt+Win+Left Arrow |
| Cmd+] | Alt+Win+Right Arrow |
| Ctrl+Option+Delete | Ctrl+Alt+Delete |
Mac profile, used for Mac computers:
| You press | Mac host receives |
|---|---|
| Option+Tab | Cmd+Tab (switch apps) |
| Ctrl+Option+Left Arrow, Ctrl+Option+Right Arrow | Ctrl+Left Arrow, Ctrl+Right Arrow (switch Spaces) |
| Ctrl+Cmd+Space | Cmd+Space (Spotlight) |
Use these conversions when macOS Shortcuts is off; it is on by default in the Mac profile.
Jump Desktop shortcuts#
Jump Desktop shortcuts are key combinations that control Jump Desktop itself, such as full screen or disconnect. While a shortcut is on, its keys are not sent to the host; turn the shortcut off to send them. You cannot change the keys a shortcut uses.
On the Keyboard Shortcuts tab:
- Clear a shortcut's checkbox to turn it off in that profile. The corresponding menu item still works when clicked.
- Enable Jump Desktop Shortcuts turns all of them on or off.
Jump Desktop shortcuts continue to work while Windows Shortcuts or macOS Shortcuts is on.
| Action | Shortcut | Menu item |
|---|---|---|
| Cycle Remote Displays | Ctrl+Shift+Right Arrow | Display > Cycle Displays |
| Lock Cursor | Ctrl+Alt+Shift+L | Remote > Lock Pointer |
| Toggle Fullscreen | Ctrl+Alt+F11 | View > Fullscreen |
| Toggle Windows Shortcuts | Ctrl+Alt+Left Arrow | Remote > Windows Shortcuts |
All four are on by default in both built-in profiles. File > Disconnect (Ctrl+Alt+W) is not in the list and is always on. Remote > Block Local Mouse uses Ctrl+Alt+Shift+M; see Block the local mouse.
| Action | Shortcut | Menu item | Windows profile | Mac profile |
|---|---|---|---|---|
| Block Local Mouse | Ctrl+Option+Cmd+M | Remote > Block Local Mouse | On | On |
| Close Window | Cmd+W | File > Close Window | On | Off |
| Cycle Displays | Ctrl+Cmd+Right Arrow | Display > Cycle Displays | On | On |
| Cycle Window | Cmd+` (backtick) | Window > Cycle | On | Off |
| Disconnect Session | Ctrl+Shift+Cmd+W | Remote > Disconnect | On | On |
| Fullscreen | Ctrl+Cmd+F | View > Fullscreen | On | On |
| Get Mac Pasteboard | Ctrl+Cmd+C | Remote > Get Pasteboard... (Apple Remote Desktop and Screen Sharing connections) | On | On |
| Hide Windows | Cmd+H | Jump Desktop > Hide Jump Desktop | On | Off |
| Lock Mouse Cursor | Ctrl+Cmd+Esc | Remote > Lock Mouse Cursor | On | On |
| Minimize Screen | Cmd+M | Window > Minimize | On | Off |
| Observe Mode | Ctrl+Shift+Cmd+O | Remote > Observe | On | On |
| Quit Jump | Cmd+Q | Jump Desktop > Quit Jump Desktop | Off | Off |
| Show All Computers | Shift+Cmd+0 | Window > Computers | On | On |
| Show Next Tab | Ctrl+Tab | (tabbed session windows) | On | Off |
| Show Previous Tab | Ctrl+Shift+Tab | (tabbed session windows) | On | Off |
| Start Dictation | Ctrl+Option+Cmd+D | Edit > Start Dictation | On | On |
| Toggle Mac Shortcuts | Ctrl+Cmd+Left Arrow | Remote > macOS Shortcuts | On | On |
| Zoom In | Option+Cmd+] | View > Zoom In | On | On |
| Zoom Out | Option+Cmd+[ | View > Zoom Out | On | On |
| Zoom To Actual Size | Option+Cmd+A | View > Actual Size | On | On |
| Zoom To Fit | Option+Cmd+W | View > Fit In Window | On | On |
What the defaults mean:
- Windows profile: Cmd+Q is sent to the host (as Alt+F4) because Quit Jump is off. Cmd+W, Cmd+H, and Cmd+M still act on Jump Desktop.
- Mac profile: Cmd+Q, Cmd+W, Cmd+H, Cmd+M, and Cmd+` (backtick) go to the Mac host.
- Other Jump Desktop menu shortcuts not in this list, such as Cmd+, and Cmd+N, go to the host during a session.
- With Enable Jump Desktop Shortcuts off, none of these shortcuts work in a session, and their key combinations go to the host. Use the menu bar to control Jump Desktop. System shortcuts still follow macOS Shortcuts.
To verify, connect and press a shortcut you turned off; the host responds instead of Jump Desktop.
Mouse and gestures#
The Mouse & Gestures tab configures mouse shortcuts; for example, to right-click with a one-button mouse or trackpad. Select a row's checkbox to turn it on, and double-click a row to change its modifier keys and button. Zoom and Remote Zoom can only be turned on or off.
| Action | Default shortcut | Windows profile | macOS profile |
|---|---|---|---|
| Right Click | Control + Left Click | Off | On |
| Middle Click | Control + Left Click (Windows profile), Control + Win + Left Click (macOS profile) | Off | On |
| Screen Scrolling | Win + Scroll | On | On |
| Zoom | Pinch gesture | On | On |
| Action | Default shortcut | Windows profile | Mac profile |
|---|---|---|---|
| Right Click | Shift + Control + Left Click (Windows profile), Control + Left Click (Mac profile) | Off | Off |
| Middle Click | Control + Cmd + Left Click | Off | Off |
| Screen Scrolling | Cmd + Scroll | Off | Off |
| Remote Zoom | Pinch gesture | On | On |
Remote Zoom Sensitivity applies to all profiles.
Extra mouse buttons#
In Fluid sessions, Jump Desktop for Windows and Mac sends your mouse's extra buttons to the host, so the back and forward side buttons work in browsers and other apps. No configuration is required. A Windows host receives the back and forward buttons; a Mac host receives up to seven extra buttons. The host requires Jump Desktop Connect 10.15.23 or later; older versions ignore the extra buttons.
Choose the profile a computer uses#
By default, each computer uses Auto (Jump Desktop for Windows) or Automatic (Jump Desktop for Mac). This setting selects the Mac profile (macOS in Jump Desktop for Windows, Mac in Jump Desktop for Mac) for Mac computers and the Windows profile for all others. To use a different profile for a computer:
- Disconnect from the computer; only disconnected computers can be edited.
- Right-click the computer and choose Edit (Ctrl+I).
- Click Keyboard & Mouse.
- Set Profile to Auto or a profile name, then click Save.
Keyboard & Mouse appears only for computers that connect with Jump Desktop Connect (Fluid), not for RDP or VNC computers.
- Right-click the computer and choose Edit... (Cmd+I).
- Click Keyboard & Mouse.
- In Keyboard, set Profile: to Automatic or a profile name, then click Save. Edit… next to it opens profile settings.
The new profile takes effect the next time you connect.
To change several computers simultaneously, select them all before you edit. If you delete a profile that a computer uses, that computer reverts to Auto (Automatic).
To verify which profile is in use, connect and press a shortcut converted only by that profile.
Add, duplicate, rename, or delete profiles#
In When connecting to, choose Edit Profiles....
In Add or Delete Profiles:
- Add: creates an empty profile named New Profile.
- Duplicate: copies the selected profile, named profile name Copy.
- Rename: double-click the name and type a new name.
- Delete: removes the selected profile immediately, with no confirmation.
- Add: click +, then Add Duplicate Profile (copies the selected profile, named profile name Copy) or Add Empty Profile (named New Profile).
- Rename: double-click the name and type a new name.
- Delete: click −. The profile is removed immediately, with no confirmation.
Click OK to finish.
Built-in profiles can be renamed but not deleted.
An empty profile has no key conversions, all Jump Desktop shortcuts on, Defer Modifiers on, and all mouse shortcuts off. The system shortcuts setting starts as In Fullscreen on Windows and off on a Mac. To start from a built-in profile's settings instead, duplicate it.
Restore defaults#
Restore Defaults resets all three tabs of the profile while keeping its name.
- Built-in profile: confirm the prompt to replace its settings with the defaults.
- Your own profile: choose Restore Windows defaults or Restore Mac defaults first.
Limitations#
- Windows: Ctrl+Alt+Left Arrow is also the Toggle Windows Shortcuts shortcut, which takes priority over the Ctrl+Alt+Left Arrow conversions in both built-in profiles. To use those conversions, turn off Toggle Windows Shortcuts and use Remote > Windows Shortcuts instead.
- Windows: you cannot choose a profile for RDP or VNC computers.
- Jump Desktop shortcuts can be turned off but not reassigned.