Mouse Mover for Moyu

macOS Compatibility: Works on all macOS versions, but requires specific permissions setup for each machine.

Dependencies

• Python 3.8+
• Xcode Command Line Tools (required on macOS)
• PyAutoGUI
• Pynput
• Tkinter (usually included with Python)

Installation

1. Download or clone this repository
2. Install Xcode Command Line Tools (if not already installed):

   xcode-select --install
   

   This is required for the Python modules to compile properly on macOS.
3. Ensure Python 3.8+ is installed on your system
4. Install dependencies:

   pip install -r requirements.txt
   

   This will install PyAutoGUI and Pynput automatically.

Running the App

Method 1: Run the GUI Application

1. Double-click on the Mover_v1 application in the mover folder
2. Set your preferred duration for each mouse movement and maximum runtime
3. Click "Start Movement"

Method 2: Run via Terminal

1. Make the script executable:

   chmod +x run_my_mover.sh
   

2. Run the script:

   ./run_my_mover.sh
   

Required Permissions

IMPORTANT: The app requires accessibility permissions on EACH Mac it runs on:

1. Open System Preferences/Settings > Security & Privacy/Privacy & Security
2. Click on the Privacy tab
3. In the left pane, scroll down and select Accessibility
4. Click the lock icon at the bottom left and enter your password to make changes
5. Click the + button and add BOTH:
   • The Mover_v1 application (if using Method 1)
   • Python: /usr/local/bin/python3 (if using Method 2)
6. Repeat steps 3-5 for Input Monitoring permission
7. Restart the app after granting permissions

Usage

• Set duration (in seconds) for each mouse movement
• Set maximum time (in minutes) the program should run
• Press "Start Movement" to begin
• To stop: Double-click or move mouse to corner manually

Troubleshooting

• If the app gets stuck after clicking "Start Movement", check your logs in log/logfile.log
• If you see "This process is not trusted!" warnings, you need to grant accessibility permissions
• Make sure the path in run_my_mover.sh points to the correct location of mover_beta.py on your system
• If you encounter compilation errors when installing dependencies, ensure Xcode Command Line Tools are installed:

  xcode-select --install
  

• On newer macOS versions, you may need to approve Python in System Settings > Privacy & Security > Developer Tools