Support

Stuck on something? Most answers are below — and a human reads every email.

Getting started

1. Install both halves — the menu-bar app on your Mac and the app on your Android device.
2. Set the same passphrase on both (12 characters minimum). This is the secret your encryption keys are derived from — treat it like a password, and make sure it matches exactly on both devices.
3. Join the same Wi-Fi network. The devices discover each other automatically — no IP addresses to type. Within a few seconds the Mac menu-bar icon and the Android status card should both show a connected peer.

From there, copy something on one device and paste on the other, or share a file to the app from either side.

Choosing a transport

• Wi-Fi (default) — fastest, and the right choice for file transfer and screen mirroring. Both devices must be on the same network.
• Bluetooth LE — works with no network at all; ideal for clipboard and notifications on the go. Expect lower throughput than Wi-Fi.
• USB cable (Developer ID Mac build) — enable USB debugging on the Android device (Settings ▸ Developer options), plug in, and accept the authorization prompt on the phone. The Mac handles the port forwarding automatically. Lowest latency, zero radio interference.

Switch transports any time from the Mac menu-bar popover or the Android app — pairing and encryption stay the same.

Android clipboard sync: what to expect

Android restricts background clipboard reads for privacy (Android 10 and later), so Android → Mac sync has two modes:

• One tap, always available — tap Sync on the app’s notification or use the Quick Settings tile after copying. The app grabs focus for a fraction of a second (the OS requirement to read the clipboard) and sends the text on.
• Fully automatic (optional) — grant “Display over other apps” in the app’s settings. For copy detection from every app, additionally grant log access once via USB debugging: adb shell pm grant com.spiritwisestudios.applestoandroids android.permission.READ_LOGS. Without it, the app still auto-detects most copies.

Mac → Android sync is automatic in all cases — no setup needed.

Troubleshooting discovery

• Same network? Both devices must be on the same Wi-Fi network and subnet. Guest networks and hotel/office Wi-Fi often isolate clients from each other, which blocks discovery — switch to Bluetooth or USB there.
• macOS firewall — if prompted, allow the app to accept incoming connections (System Settings ▸ Network ▸ Firewall). The app listens on TCP port 34567 on your local network only.
• Passphrases must match exactly — a mismatch looks like “connected but nothing syncs.” Re-enter the passphrase on both devices if in doubt.
• Still stuck? Toggle the transport off and on (or quit and reopen the Mac app) to restart discovery, and make sure both apps are up to date.

System requirements

• macOS 13 Ventura or later. Two flavors exist: the Developer ID build (full feature set, including proximity auto-unlock and USB mode) and the Mac App Store build (sandboxed; those two features are omitted).
• Android 11 or later, phone or tablet.

Report a problem

Email us with what you expected vs. what happened, your macOS and Android versions, and the transport you were using (Wi-Fi, Bluetooth, or USB). Screen recordings help enormously.

Contact

Email jeremy@spiritwisestudios.com — we aim to reply within two business days.