💻 Anti-Lock Script – Multi-platform Mouse Jiggler

---

This Python utility prevents your screen from locking by simulating a small mouse movement every 60 seconds.
It's available for Windows, macOS (Apple Silicon), and Linux (.deb / .rpm) via GitHub Releases.

---

💖 Sponsor this project

If you find this project useful, consider supporting it 🙏

📦 Supported Platforms

Platform	Format	Built with
Windows	.exe	PyInstaller
macOS	.app / .dmg	py2app
Linux	.deb / .rpm	PyInstaller + FPM

🚀 How It Works

Every 60 seconds, the script moves the mouse by 1 pixel and back, preventing screen lock due to inactivity.

🔧 How to Use

Download the appropriate binary from the Releases section, then run it:

• Windows: Double-click anti_lock.exe
• macOS: Unzip and launch the .app. May require System Preferences > Security > Allow Anyway.
• Linux: Install with sudo dpkg -i or sudo rpm -i

💻 Manual Usage (Python Script)

You can also run the Python script directly:

pip install pyautogui
python anti_lock.py

To stop the script, press Ctrl+C.

🛠️ Build Locally

Windows (via GitHub Actions or manually)

pip install pyinstaller
pyinstaller --onefile --windowed anti_lock.py

macOS (Apple Silicon)

pip install py2app
python setup.py py2app

Linux (Debian/Redhat)

sudo apt install ruby ruby-dev build-essential rpm
sudo gem install fpm
pip install pyinstaller
pyinstaller --onefile anti_lock.py
fpm -s dir -t deb -n anti_lock -v 1.0.0 -C pkg
fpm -s dir -t rpm -n anti_lock -v 1.0.0 -C pkg

🤖 CI/CD with GitHub Actions

This repository includes a GitHub Actions workflow that:

• Builds the script for all major platforms.
• Publishes artifacts to GitHub Releases when a tag like v1.0.0 is pushed.

🧪 Local Development Setup (macOS M1 compatible)

1. Clone this repository

git clone https://github.com/amarnaud2/anti-lock-multiplatform.git
cd anti-lock-multiplatform

2. Create a virtual environment

python3 -m venv .venv

3. Activate the virtual environment

source .venv/bin/activate

4. Install dependencies

pip install -r requirements.txt

5. Run the script

python anti_lock.py

6. Deactivate the virtual environment

deactivate

---

☕ Support

If you’d like to say thanks or help keep this project going:

• 💛 Buy Me a Coffee
• 💙 Ko-fi
• 💳 PayPal

Every contribution helps — thank you!

📜 License

MIT License – free to use, modify and distribute.