microsoft--powertoys/doc/dsc/modules/MouseJump.md

description, ms.date, ms.topic, title

description	ms.date	ms.topic	title
DSC configuration reference for PowerToys MouseJump module	10/18/2025	reference	MouseJump Module

MouseJump Module

Synopsis

Manages configuration for the Mouse Jump utility, which enables quick navigation across large or multiple displays.

Description

The MouseJump module configures PowerToys Mouse Jump, a utility that provides a miniature preview of all your displays, allowing you to quickly jump your mouse cursor to any location. This is particularly useful with large monitors or multi-monitor setups.

Properties

The MouseJump module supports the following configurable properties:

ActivationShortcut

Sets the keyboard shortcut to activate Mouse Jump.

Type: object
Properties:

• win (boolean) - Windows key modifier
• ctrl (boolean) - Ctrl key modifier
• alt (boolean) - Alt key modifier
• shift (boolean) - Shift key modifier
• code (integer) - Virtual key code
• key (string) - Key name

Default: Win+Shift+D

ThumbnailSize

Sets the size of the screen thumbnail preview.

Type: string
Allowed values:

• "small" - Smaller thumbnail for faster performance
• "medium" - Balanced size and performance
• "large" - Larger thumbnail for better visibility

Default: "medium"

Examples

Example 1 - Configure activation shortcut with direct execution

This example customizes the Mouse Jump activation shortcut.

$config = @{
    settings = @{
        properties = @{
            ActivationShortcut = @{
                win = $true
                ctrl = $false
                alt = $false
                shift = $true
                code = 68
                key = "D"
            }
        }
        name = "MouseJump"
        version = "1.0"
    }
} | ConvertTo-Json -Depth 10 -Compress

PowerToys.DSC.exe set --resource 'settings' --module MouseJump `
    --input $config

Example 2 - Configure thumbnail size with DSC

This example sets a larger thumbnail for better visibility.

dsc config set --file mousejump-size.dsc.yaml

# mousejump-size.dsc.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
  - name: Configure Mouse Jump thumbnail
    type: Microsoft.PowerToys/MouseJumpSettings
    properties:
      settings:
        properties:
          ThumbnailSize: large
        name: MouseJump
        version: 1.0

Example 3 - Install and configure with WinGet

This example installs PowerToys and configures Mouse Jump for multi-monitor setups.

winget configure winget-mousejump.yaml

# winget-mousejump.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2023/08/config/document.json
metadata:
  winget:
    processor: dscv3
resources:
  - name: Install PowerToys
    type: Microsoft.WinGet.DSC/WinGetPackage
    properties:
      id: Microsoft.PowerToys
      source: winget
  
  - name: Configure Mouse Jump
    type: Microsoft.PowerToys/MouseJumpSettings
    properties:
      settings:
        properties:
          ThumbnailSize: medium
        name: MouseJump
        version: 1.0

Example 4 - Performance-optimized configuration

This example uses a smaller thumbnail for better performance.

dsc config set --file mousejump-performance.dsc.yaml

# mousejump-performance.dsc.yaml
$schema: https://aka.ms/dsc/schemas/v3/bundled/config/document.json
resources:
  - name: Performance-optimized Mouse Jump
    type: Microsoft.PowerToys/MouseJumpSettings
    properties:
      settings:
        properties:
          ThumbnailSize: small
        name: MouseJump
        version: 1.0

Example 5 - Large display configuration

This example configures for large or high-DPI displays.

$config = @{
    settings = @{
        properties = @{
            ThumbnailSize = "large"
        }
        name = "MouseJump"
        version = "1.0"
    }
} | ConvertTo-Json -Depth 10 -Compress

PowerToys.DSC.exe set --resource 'settings' --module MouseJump --input $config

Use cases

Multi-monitor workstations

Configure for efficient navigation across multiple displays:

resources:
  - name: Multi-monitor configuration
    type: Microsoft.PowerToys/MouseJumpSettings
    properties:
      settings:
        properties:
          ThumbnailSize: medium
        name: MouseJump
        version: 1.0

Large displays

Configure for ultra-wide or 4K+ displays:

resources:
  - name: Large display configuration
    type: Microsoft.PowerToys/MouseJumpSettings
    properties:
      settings:
        properties:
          ThumbnailSize: large
        name: MouseJump
        version: 1.0

See also

• Settings Resource
• PowerToys DSC Overview
• FindMyMouse