dboyd42 / jiggly-mouse

A portable mouse jiggler program written in Python3 for Linux, macOS, and Windows

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Jiggly Mouse

Author: David Boyd
Date: 2022-03-21

This program jiggles your mouse to prevent your computer from going to sleep or to screensaver mode. I wrote this program because most of the mouse jiggler programs were written for only Windows. This has been tested in both macOS (Monterey) and Windows 11. For argument's sake, I'll just assume this works in Linux as this program was purposefully written in Python3 to be cross-platform.

Installation

Running the Binary -- Overview

Provided binaries:

  • ✅ Windows: ./binaries/jiggly-mouse-win-x64.exe
  • ✅ macOS: ./binaries/jiggly-mouse-macOS.app
  • ⏲️ Linux: ./binaries/jiggly-mouse-linux.elf
  • ❌ WSL2 + Kali-Win-Kex (TigerVNC): No luck 🤷
  1. Download the platform relative binary to desired directory (ie. Desktop)

  2. Open the program where and accept the prompts

macOS - Monterey


Bypassing Apple's Unidentified Developer

  1. Unzip application (if applicable)
  2. In the Finder on your Mac, locate the app you want to open.
    Don’t use Launchpad to do this. Launchpad doesn’t allow you to access the shortcut menu.
  3. Control-click the app icon, then choose Open from the shortcut menu.
  4. Click Open.

The app is now saved as an exception to your security settings, and you can open it in the future by double-clicking it just as you can any registered app.

  1. Upon prompt: Security & Privacy > Accessibility > Allow jiggly-mouse-macOS.app
    • This is required because the program is taking over your mouse

Windows 11


  • Prompt: Windows protected your PC
    1. Click More info
    2. Click Run anyway

Linux


  • (will update once tested)

Running via Python3-CLI

Dependencies


  • PIP: PyAutoGui for GUI mouse control
  • macOS: Tkinter has issues, so good luck. I messed up my soft-linked files by installing it via brew... dunno what else it messed up.
    • Running the jiggly-mouse-macOS.app binary resolves this issue.

Run via CLI


  • python3 jiggly-mouse.py or use whatever setup you have at this point.
  • Or allow permissions: chmod u+x jiggly-mouse.py && ./jiggly-mouse.py

About

A portable mouse jiggler program written in Python3 for Linux, macOS, and Windows


Languages

Language:Python 100.0%