Skip to content

Mouse Jiggler

Mouse Jiggler

Feature overview

Mouse Jiggler simulates mouse movement to:

  • Prevent sleep or standby
  • Stop screen savers from activating
  • Run automatically in the background
  • Avoid interfering with normal use

Enable

  1. Edit /etc/kvmd/override.yaml: 

    1
2
3
4
5
    kvmd:
    hid:
        jiggler:
            enabled: true    # Show in menu
            active: true     # Auto-start on boot (optional)

  2. Restart kvmd: 

    1
    sudo systemctl restart kvmd

  3. Enable it from the top-right system menu:

Mouse Jiggler Toggle

How It Works

Behavior

  1. The system monitors user input (keyboard and mouse)
  2. After 60 seconds of inactivity:
  3. Absolute mode: move to (-100, -100) -> wait -> (100, 100) -> wait
  4. Relative mode: move (-10, -10) -> wait -> (10, 10) -> wait
  5. Repeat until user input is detected

Highlights

  • Supports both absolute and relative modes
  • Coordinates adjust to screen resolution
  • Runs even if the web UI is closed
  • Pauses automatically when the user is active
  • Only starts after 60 seconds of inactivity

Use Cases

  • Monitoring software installs remotely
  • Preventing auto lock or sleep
  • Keeping systems active
  • Long unattended operations