Grab the DMG from the latest release, drag Link to Mac into Applications and launch it — it lives in your menu bar. LAN-direct sync is on by default, so on the same Wi-Fi there is nothing to configure.

Prefer building from source? Clone the repo and open the Xcode project:

git clone https://github.com/grkndev/LinkToMac.git
cd LinkToMac/mac
xcodegen generate && open LinkToMac.xcodeproj

Sideload the APK from the same release page (it's a personal-use project — it isn't on the Play Store). Then enable Developer options → Wireless Debugging — the app uses it once to grant itself background clipboard access.

Building it yourself instead:

cd LinkToMac/mobile
bun install
bun run android   # dev client — Expo Go is not supported

Open Show pairing QR from the Mac's menu-bar icon and scan it with the phone app. The code carries everything — the pairing secret, the Mac's LAN port, and the relay address if you've set one — so both ends configure themselves. Copy something and paste it on the other device; you're linked.

Only needed to keep syncing when phone and Mac are on different networks. It's a tiny Node.js WebSocket server; run it on any box you own:

cd LinkToMac/server
cp .env.example .env   # set RELAY_AUTH_TOKEN
docker compose up -d   # or: npm install && npm run dev

Put it behind a reverse proxy with TLS (wss), then add its address in the Mac app under Server Settings… and re-show the QR — the phone picks it up on the next scan and still prefers the direct LAN link whenever you're home.