# Remote Mouse Suite — Linux desktop helper

This is the free desktop helper that lets the **Remote Mouse Suite** phone app
control this computer over **Wi-Fi**. Both devices must be on the same local
network. (Bluetooth mode in the app needs nothing installed here.)

## Install

```bash
unzip RemoteMouseSuite-Linux-x86_64.zip
cd RemoteMouseSuite-Linux-x86_64
./install.sh
```

`install.sh` installs `xclip` (used for typing text), copies the binary to
`~/.local/bin/RemoteMouseSuite`, and prints how to run it.

## Run

```bash
RemoteMouseSuite            # or:  ~/.local/bin/RemoteMouseSuite
```

Then, in the phone app, switch the Trackpad/Keyboard to **Wi-Fi** and tap this
computer when it appears. A pairing code shows on this screen — enter it on the
phone once.

Useful flags:

| Flag | What it does |
|------|--------------|
| `--verbose` | Debug logging + periodic throughput stats |
| `--install-autostart` | Run automatically at login (writes a systemd `--user` unit) |
| `--uninstall-autostart` | Remove the autostart entry |
| `--unpair-all` | Forget every paired phone |

## Requirements & notes

- **Ports:** the helper listens on **UDP 8888** (discovery + cursor stream) and
  **TCP 8889** (commands). If you run a firewall (`ufw`, `firewalld`), allow
  inbound traffic on those ports from your LAN.
- **Wayland:** pynput can move the pointer but usually **cannot inject
  keystrokes** under Wayland. For full keyboard support, pick an **Xorg / X11**
  session at the login screen.
- **Unsigned binary:** this build is not signed. If your file manager marks it
  non-executable, run `chmod +x RemoteMouseSuite` (the installer already does
  this for the installed copy).

## Uninstall

```bash
RemoteMouseSuite --uninstall-autostart   # if you enabled autostart
rm ~/.local/bin/RemoteMouseSuite
```
