Remote Mouse

Use your phone as a touchpad for your Mac or Windows PC over your local Wi-Fi network.

Only run this on a trusted private network. Anyone who can reach the server URL can send mouse and keyboard input to your computer.

Setup on macOS

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

Setup on Windows

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt

Run on macOS

chmod +x run.sh (first time only)
./run.sh

Run on Windows

.\run.cmd

Open the printed http://...:8765/ address on your phone. The phone and computer must be on the same Wi-Fi network.

The app also prints a QR code in the terminal for the first reachable local URL.

macOS Permission

The first time you use it, macOS may block the generated mouse events. Open:

System Settings > Privacy & Security > Accessibility

Enable the terminal app you used to launch the server. If Python appears separately in that list, enable Python too. Then restart the server.

The same permission is used to send keystrokes from the app's virtual keyboard.

Windows Permission

The first time you run the server, Windows Firewall may ask whether Python can accept network connections. Allow access on your private network so your phone can connect.

Controls

• One-finger drag: move the pointer
• Tap: left click
• Quick double tap: double click
• Quick second press and hold: click and hold until release
• Long press: right click
• Two-finger drag: scroll
• Use - and + beside Speed to adjust pointer speed
• Keyboard is off by default
• Tap the Keyboard off footer button to show it, and tap Keyboard on to close it
• Ctrl toggles Command on macOS or Control on Windows for the next virtual keyboard key

Options

./run.sh --port 9000 --sensitivity 1.2

.\run.cmd --port 9000 --sensitivity 1.2

Add --debug to log each HTTP request while troubleshooting.