Skip to main content

Jiggler Pro

A professional, zero-dependency mouse jiggler that keeps your computer awake by simulating human-like activity.

Why Jiggler Pro

Jiggler Pro is designed for users who need a reliable, lightweight, and undetectable way to keep their systems active. Unlike other tools that require heavy dependencies or move the mouse in obvious, repetitive patterns, Jiggler Pro offers:

  • Indistinguishable Activity: Stealth Mode uses randomized movement and timing to mimic a real user, making it much harder for monitoring software to flag.
  • Zero Installation Footprint: It uses native system APIs (ctypes) rather than installing large libraries like pyautogui, keeping your environment clean.
  • System Integrity: It always returns your cursor to its original position, ensuring it doesn't interfere with your work when you return to your desk.
  • Universal Compatibility: A single codebase that runs natively on macOS, Windows, and Linux.

Quick Start

1. Installation

Install from PyPI:

pip install jiggler-pro

Already installed? Upgrade to the latest version:

pip install --upgrade jiggler-pro

To install from a local copy of this repository instead, run pip install . in the project folder.

2. Basic Usage

Once installed, simply run:

jiggler-pro

By default, it jiggles every 30 seconds.


Examples

Goal Command
Fast Jiggle (every 5s) jiggler-pro 5
Low Frequency (every 2m) jiggler-pro 120
Human-like Stealth jiggler-pro --stealth
Move + Click jiggler-pro --click
Subtle Nudge (1 pixel) jiggler-pro -p 1
Long Distance (50 pixels) jiggler-pro -p 50
Balanced Stealth jiggler-pro 10 -s
Keep Awake (no mouse movement) jiggler-pro --keep-awake
Stop After 2 Hours jiggler-pro --duration 2h
Stop at End of Day jiggler-pro --until 18:00
Keep Awake Until 17:30 jiggler-pro -k -u 17:30

Arguments and Options

Parameter Type Default Description
seconds Positional 30 The interval between jiggles in seconds (minimum 1).
-p, --pixels Integer 7 The distance in pixels the mouse will move (minimum 1).
-s, --stealth Flag False Enables randomized timing, distances, and movement patterns.
--click Flag False Also clicks at the cursor after each movement. Use with care: it clicks whatever is under the cursor.
-k, --keep-awake Flag False Blocks system and display sleep through the OS instead of moving the mouse. Can't be combined with the mouse options above.
-d, --duration Duration — Stops automatically after this long, e.g. 90s, 45m, 2h30m.
-u, --until Time — Stops automatically at this time (24-hour HH:MM). Rolls over to tomorrow if the time has passed.
-q, --quiet Flag False Hides the live countdown; only the start and summary messages are shown.
--version Flag — Prints the version and exits.

Colors are turned off automatically when output isn't a terminal or when the NO_COLOR environment variable is set.

Keep-Awake vs. Mouse Jiggling

--keep-awake asks the OS not to sleep (SetThreadExecutionState on Windows, caffeinate on macOS, systemd-inhibit on Linux). It never touches your cursor and needs no special permissions, but apps that track your own activity (for example chat "Away" statuses) may still mark you as away. Mouse jiggling covers those cases.


Platform Notes

  • macOS: Mouse jiggling needs Accessibility access for your terminal app (System Settings > Privacy & Security > Accessibility). Jiggler Pro exits with a message if it's missing. --keep-awake doesn't need it.
  • Linux: Mouse jiggling requires X11 with libX11 and libXtst. Wayland is not supported for mouse movement; use --keep-awake there (requires systemd). Some desktops may still blank the screen even while sleep is blocked.

Interactive Controls

Key Action
SPACE / ENTER Stop and exit safely.
Ctrl + C Stop and exit safely.

Features

  • Zero Dependencies: No extra libraries needed—runs on pure Python.
  • Stealth Mode: Randomizes movement patterns and timing to stay undetected.
  • Cross-Platform: Works natively on macOS, Windows, and Linux.
  • Safe: Always returns the mouse to the exact spot it started.

License

MIT

Metadata

Release files for jiggler-pro 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jiggler-pro 0.2.0
File Size Uploaded Provenance Actions
jiggler_pro-0.2.0.tar.gz 14.3 kB With provenance Details for jiggler_pro-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for jiggler-pro 0.2.0
File Interpreter ABI Platform Actions
jiggler_pro-0.2.0-py3-none-any.whl Python 3 none any Details for jiggler_pro-0.2.0-py3-none-any.whl

Total release size: 29.5 kB

Release files / jiggler_pro-0.2.0.tar.gz

Download URL jiggler_pro-0.2.0.tar.gz
Size 14.3 kB
Tags Source
SHA-256 checksum
How to use checksums
97b0e895f59d2a2f4606d183eef0e67c2806daab07f25e6a252ce0ed7fb75aba
BLAKE2b-256 checksum
How to use checksums
5a6015825baa77debebf259932668dde567ef5e1b537a120b82f8f94fc69ba91
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.

Transparency log

Release files / jiggler_pro-0.2.0-py3-none-any.whl

Download URL jiggler_pro-0.2.0-py3-none-any.whl
Size 15.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f8ecc191b093e5c82c4337a60b2c30b0009e0d28686d64f5bef618fb2f869111
BLAKE2b-256 checksum
How to use checksums
3876cfc58de40bf8ee9e085db963c03dcacae65c9f2ee148fc11605856809b9b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.

Transparency log

Security for jiggler-pro 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for jiggler_pro-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 31, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page