Skip to main content

A simple mouse jiggler for MacOS

Project description

Mouse Jiggler

[!NOTE] This currently only works for MacOS however, support for other operating systems coming soon!

Steps to Setup

  1. Clone the Repo: git clone https://github.com/UmairK5669/mouse-jiggler.git

  2. Install the dependencies: pip install -r requirements.txt

  3. Simply run the program: python3 jiggler.py

Your program should be ready to go, simply use the shortcuts 'cmd' + 'shift' + 'u' to start jiggling and 'cmd' + 'shift' + 'k' to stop jiggling.

Using Tmux

It's recommended to have this running in a tmux session so it can run in the background without issues.

Steps for using Tmux in Terminal

  1. Install tmux using Homebrew: brew install tmux

[!TIP] If you don't have the brew package manager installed, please install it here

  1. Start a tmux session: tmux new-session -s mysession

    Replace mysession with your desired session name

  2. Start the process in the tmux session: python3 'path/to/jiggler.py'

[!CAUTION] You might want to install the dependencies again in the tmux session as it could cause issues if you don't

  1. Close the Terminal, and terminate this process.

Your jiggler is setup in the background and won't end process when your computer sleeps. In the event of a computer restart, you will need to restore the tmux session manually.

Author Thank You

Thank you for getting this far with my app, I really hope you were able to set it up and use it without issues. Please don't hesitate to contact me for any issues or for collaboration as I'm always up for innovation! Reach out via email or social links from my GitHub profile. Thanks 😄!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mouse_jiggler_macos-0.1.0.tar.gz (3.2 kB view details)

Uploaded Source

Built Distribution

mouse_jiggler_macos-0.1.0-py3-none-any.whl (3.7 kB view details)

Uploaded Python 3

File details

Details for the file mouse_jiggler_macos-0.1.0.tar.gz.

File metadata

  • Download URL: mouse_jiggler_macos-0.1.0.tar.gz
  • Upload date:
  • Size: 3.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.11.8

File hashes

Hashes for mouse_jiggler_macos-0.1.0.tar.gz
Algorithm Hash digest
SHA256 8f565331f8f9a7f740424556238504abcf1c8892feb6eb2ee7550d503cbebbda
MD5 6241704fa82b333cfbeaaac2acb0ac62
BLAKE2b-256 c848e881904e930d0923907624b21d261f5fda2421393295ba1db4d59be960d4

See more details on using hashes here.

File details

Details for the file mouse_jiggler_macos-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mouse_jiggler_macos-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 15b0be25c41e5c222b2533218bb424b17e5d155ff24af505fa3c380d5df7c106
MD5 a3b8822ef065147103e842f0ee2cf11c
BLAKE2b-256 4f8eeb8241388c80a6d2ce8538bac2deb46ee4e2e083719cbcbb4fc97d760464

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page