Skip to content

Windstar343/mouse-jiggler

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 

Repository files navigation

🖱️ Mouse Jiggler with Keyboard Control 🖥️

A simple Python script to keep your computer active by wiggling the mouse. Activate and deactivate the jiggler with the F5 key. Perfect for avoiding idle status during online meetings or long breaks!

🚀 Features

  • Random Mouse Movements: Simulates natural mouse behavior by moving to random positions.
  • Toggle Control: Start or stop the jiggler anytime using the F5 key. F9 to center the mouse and F10 to exit the program.
  • Lightweight & Easy to Use: Requires minimal setup and runs in the background.

🛠️ Requirements

  • Python 3.6 or later
  • Install the required Python packages using:
pip install pyautogui pynput

📋 Usage

  1. Clone this repository or copy the script.
  2. Install the dependencies listed above.
  3. Run the script:
python mouse_jiggler.py
  1. Press F5 to start or stop the mouse jiggler.
  2. Press F9 to center the mouse.
  3. Press F10 to exit the program.

📄 Code Overview

Main Components:

  • Mouse Wiggling: The wiggle_mouse function moves the mouse to random nearby positions every 3 seconds.
  • Keyboard Listener: The script listens for F5 key presses to toggle the jiggler on and off.

Key Functions:

def wiggle_mouse():
    # Moves the mouse randomly every 3 seconds when active.
    
def on_press(key):
    # Toggles the Controls with the F5, F9 and F10 key.

🖼️ Preview

When activated, the script:

  • Randomly moves the mouse by ±100 pixels.
  • Displays a message in the terminal:
Press F5 to start/stop the mouse jiggler.
Press F9 to center the mouse.
Press F10 to exit the program.

🔒 Notes

  • System Impact: Minimal CPU usage.
  • Responsibility: Use this tool ethically and consider workplace or system policies.

💡 Ideas for Improvement

  • Add a GUI to control settings (e.g., jiggle interval, distance).
  • Add support for customizable toggle keys.

Enjoy your uninterrupted sessions! 😄

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages