Docs / Start here

Installing the computer app

One file per system, free. What happens the first time it runs, the permissions it needs, and how to update or remove it.

The computer app has no window and no icon. It runs quietly, opens its pairing page in your browser the first time, and waits for the phone. Opening it again while it runs simply opens the pairing page.

Mac

Download AirMouse-Server-macOS.zip and open it.
Drag AirMouse Server into Applications and open it. It is signed and notarised, so macOS opens it like any other app. If you open it straight from Downloads, it moves itself to your Applications folder and tells you so.
Grant Accessibility when it asks: System Settings → Privacy & Security → Accessibility → AirMouse Server. Without it the cursor cannot move. The app restarts itself once you switch it on.
Screen Recording is asked for only when you first turn on the live screen. Everything else works without it.
On macOS Sequoia and later, macOS may ask about Local Network. Allow it; if you said no, switch it on in System Settings → Privacy & Security → Local Network, then quit and reopen AirMouse Server.

The Mac app does not start by itself after a restart. Open AirMouse Server from Applications again, or add it under System Settings → General → Login Items.

Windows

Download AirMouse-Setup.exe and run it.
Windows may show "Windows protected your PC". Click More info, then Run anyway.
It asks "Install AirMouse on this computer?". Yes installs it and starts it with Windows; No runs it once; Cancel quits.
Installing adds a firewall rule for Private networks, which may show one administrator prompt. If Windows asks which networks to allow, tick Private networks.

The firewall rule covers Private networks only. If your Wi-Fi is marked Public in Windows, the phone cannot connect. Change it under Settings → Network & internet → Wi-Fi → your network → Private.

Installing puts the app in %LOCALAPPDATA%\AirMouse, adds a Start menu shortcut and an entry in Settings → Apps.

Linux

Download AirMouse-Server-Linux.tar.gz and unpack it.
Run ./airmouse-server from the unpacked folder. Nothing is installed until you ask.
To start it with your desktop, run ./airmouse-server --install. It copies itself to ~/.local/bin and adds an autostart entry.

To move the pointer it tries, in order: /dev/uinput if you already have access, XTest on an X11 session, then the desktop's remote-desktop portal, which shows one Allow dialog and remembers your answer. If none works, it offers to set up uinput access, which takes effect after you log out and back in. On a headless machine, --grant-uinput does the same from a terminal.

Optional packages:

For	Install
Clipboard	`wl-clipboard` on Wayland, `xclip` or `xsel` on X11
The Allow dialog	`zenity` or `kdialog` (without them, pairing uses the code)
Volume	`wpctl` (PipeWire) or `pactl`

./airmouse-server --doctor prints the session type and moves the pointer to show whether input works.

Updating

There is no automatic updater yet. Download the new file and open it the same way; it replaces the old one and keeps your paired phones.

Removing it

Mac: quit AirMouse Server, delete it from Applications, and optionally delete ~/Library/Application Support/AirMouse and ~/Library/Logs/AirMouse-server.log.
Windows: Settings → Apps → AirMouse → Uninstall, or run AirMouse.exe --uninstall. Your settings in %APPDATA%\AirMouse stay unless you delete them.
Linux: airmouse-server --uninstall removes the copy and the autostart entry.