AirMouseDocs / Reference
Computer app reference
Files, logs and command-line options of AirMouse Server, for people who like to look under the hood.
Files
| Mac | Windows | Linux | |
|---|---|---|---|
| Settings and paired phones | ~/Library/Application Support/AirMouse/config.json | %APPDATA%\AirMouse\config.json | ~/.config/AirMouse/config.json |
| Log | ~/Library/Logs/AirMouse-server.log | %LOCALAPPDATA%\AirMouse\airmouse-server.log | ~/.local/state/AirMouse/airmouse-server.log |
config.json holds the computer's id and name, the port, and the paired phones as hashed tokens.
Options
| Option | What it does |
|---|---|
--name <name> | The name phones see |
--port <n> | Listen on another port (default 1978; the pairing page uses the next one) |
--pair | Open the pairing page |
--devices | List paired phones |
--forget <name or id> | Unpair one phone |
--reset-trusted | Make every phone ask again |
--allow-shell | Allow shell steps in macros |
--serve | Run without opening the pairing page |
--dry-run | Accept connections but inject nothing (for testing) |
--check | Mac: report whether Accessibility is granted |
--install / --uninstall | Linux and Windows: install or remove the app and its autostart |
--grant-uinput | Linux: set up uinput access for the current user |
--doctor | Linux: report the session and test the pointer |
--config <path> | Use another settings file |
On a Mac, run options from Terminal with the binary inside the app, for example "/Applications/AirMouse Server.app/Contents/MacOS/airmouse-server" --devices.