Your Android phone and your Mac, working as one.
Set it up once, then it just works: clipboard, codes, notifications, files, photos, mirroring and Find My Phone,
over your own Wi‑Fi. Tiny, fully open source, no account and no cloud.
Download · macOS 14 or later · Android 14 or later · free, MIT licensed
Apple makes a Mac and an iPhone feel like one device. Macindroid does that for a Mac and an Android phone, as far as the two systems allow, and holds itself to six things:
| What it means here | |
|---|---|
| Simple | Three steps to set up, all by clicking and scanning: no Terminal, no cable, no account. |
| Just works | After that you don't open it. It sits in the menu bar, finds the phone by itself and reconnects within seconds, even with the phone's screen off. |
| Very small | The phone app is a 110 KB download. The Mac app's own code is about 1.1 MB; the 20 MB disk image is mostly scrcpy and adb, bundled so mirroring needs nothing else. Idle, the Mac app uses 0.0 % CPU and 35 MB of memory. |
| Fully open source | MIT licensed, about 4,600 lines of Swift and 5,400 of Java, with no third‑party libraries, no analytics and no servers of its own. The bundled scrcpy and adb are the official open‑source builds, checked against pinned checksums. |
| Beautifully designed | A native menu‑bar app on the Mac; a phone app drawn in the icon's style, with a switch for every feature. |
| Feature rich | Everything below, plus how it compares with Apple's own Continuity. |
| Universal clipboard | Copy on one, paste on the other: text and images, both ways, in about a quarter of a second. Passwords copied from a password manager are never sent. |
| One‑time codes | A sign‑in or verification code that reaches your phone, by text message or in an app's notification, is on the Mac's clipboard within about a second, ready to paste: Code 482913 from Google copied. Clipboard managers don't keep it, and it's cleared after two minutes. |
| Notifications on your Mac | Your phone's notifications appear on the Mac while you aren't using the phone, with Reply and the app's own buttons. Clear one on either device and it clears on the other, also when they were apart at the time; click one on the Mac and it opens on the phone. |
| Files and links | Drop files on the menu‑bar icon, or Share → Macindroid on the phone. Files are checksummed and land in Downloads. Send the browser tab you're looking at to the phone in one click. |
| Photos and screenshots | Take a photo or a screenshot on the phone and a preview drops down from the menu‑bar icon: copy it, save it to Downloads or drag it anywhere, at full resolution. |
| Mirror your phone | Use your phone in a window on the Mac, with its sound, over USB or Wi‑Fi, through the bundled scrcpy. |
| Calls | A call ringing on the phone shows on the Mac with Answer and Decline, for the phone's own calls and for apps like WhatsApp. Click a phone number on the Mac and, once you confirm, the phone dials it. The call's sound stays on the phone or its headset. |
| Your phone in Finder | Show Phone in Finder mounts the phone's storage as a disk: browse it, open files, drag things in and out, rename and delete, like any other folder. |
| Lock when you leave | Optional: the Mac locks about 40 seconds after your phone leaves the Wi‑Fi network or is switched off. A phone asleep on the desk doesn't count as gone. |
| Find your phone | Ring Phone plays an alarm at full volume, even on silent or Do Not Disturb, until you unlock it or press Stop. |
| At a glance | The menu shows your phone's battery and connection. The menu‑bar icon shows a progress ring while files move and a ringing bell while the phone rings. |
| Your choice | Every feature is on from the start and has its own switch in the phone app. |
Apple's Continuity features that apply to a Mac and a phone, and where Macindroid stands on each:
| Continuity | Macindroid |
|---|---|
| Universal Clipboard | ✅ Text and images, both ways |
| Security codes from Messages, filled in on the Mac | ✅ Codes from texts and apps go straight to the clipboard |
| AirDrop | ✅ Files both ways, links both ways |
| iPhone Mirroring | ✅ With sound, keyboard and mouse, over USB or Wi‑Fi |
| Notifications from iPhone on the Mac | ✅ With Reply and the app's own buttons, and clears kept in step both ways |
| Find My (play a sound) | ✅ Rings even on silent |
| Continuity Camera: take a photo for the Mac | ◐ New photos and screenshots pop up on the Mac, ready to drag in |
| Handoff | ◐ Browser tabs and links, not app state |
| Text Message Forwarding | ◐ Reply to a text from its notification; no conversation view yet |
| iPhone Cellular Calls | ◐ Ringing calls show with Answer and Decline, and the Mac can dial; the call's sound stays on the phone |
| Continuity Camera as a webcam | ✗ Needs a macOS camera extension, which needs an Apple developer account |
| Instant Hotspot, Auto Unlock, Apple Pay, Continuity Sketch, iPhone widgets | ✗ Android or macOS don't let a third‑party app do these |
And two things Continuity doesn't do with an iPhone: the phone's storage as a disk in Finder, and locking the Mac when the phone leaves.
You need a Mac with macOS 14 or later and an Android phone with Android 14 or later, on the same Wi‑Fi. No Terminal, no cable.
Download Macindroid-1.2.2.dmg from the latest release,
open it and drag Macindroid into Applications.
Macindroid isn't notarized by Apple yet, so the first time you open it macOS says it can't check it. Click Done, open System Settings → Privacy & Security, scroll down and click Open Anyway, then open Macindroid again. (The disk image shows these steps too.) Allow it to find devices on your local network, and to send notifications.
Its icon, a face that's half Mac and half Android, appears in the menu bar, and a Set Up Your Phone window opens.
- Scan the QR code in that window with the phone's camera. It downloads the Macindroid app for Android; open the download and tap Install (if Android asks, allow installing apps from your browser).
- Open Macindroid on the phone, tap Get started and pick your Mac.
- The Mac and the phone each show a six‑digit code. Check they match, then click Pair on the Mac.
- Tap Allow all. The phone opens each of Android's permission screens in turn and comes back after each one. For One‑time codes, Android asks you to pick your Mac from nearby Bluetooth devices; open System Settings → Bluetooth on the Mac so it shows up.
That's it: clipboard, notifications, codes, photos, files, links and Find My Phone all work, and every feature starts switched on. The Macindroid app on the phone lists them, each with its own switch. Open it from the app drawer, or add its Quick Settings tile (the app offers to).
Two things need a one‑time step from the Mac, because Android only lets a computer grant them: copies on the phone reaching the Mac by themselves (otherwise you send them with Send clipboard or Share), and mirroring over Wi‑Fi.
- On the phone, tap Set up power features in Macindroid. The Mac shows a QR code.
- Turn on Developer options: in Settings → About phone, tap Build number seven times (on some phones it's under Version or Software information). Macindroid opens that screen for you.
- In Developer options → Wireless debugging, turn it on, tap Pair device with QR code and scan the code on the Mac.
The Mac installs or updates the phone app, grants those permissions (and the ones from step 2.4, if any are still missing) and switches Wireless debugging off again. Android then asks once whether Macindroid may access all device logs: tap Allow. A phone plugged in with USB debugging on works too, without the QR code. You can also start it from the Mac: Settings → Set Up Power Features… in the Macindroid menu.
Prefer Terminal?
setup-phone.sh from the release does the same over USB, using the adb inside the app:
ADB=/Applications/Macindroid.app/Contents/Helpers/adb bash ~/Downloads/setup-phone.sh
When a new version is out, the Mac notifies you and the menu shows Install Macindroid 1.x: it downloads the release, checks it against the release's checksums and its signature, swaps itself and relaunches, in a few seconds. The phone then shows Update on its Home screen (and a notification); tap it and Android asks you to confirm. The new phone app comes from the Mac over the encrypted link, not from the internet. The first time, Android also asks you to let Macindroid install apps: allow it and come back, and the update carries on.
- Copy and paste as usual, on either device.
- Send files by dropping them on the menu‑bar icon, choosing Send Files…, or Open With → Macindroid in
Finder. On the phone, use Share → Macindroid. Files arrive in
Downloadson the Mac and inDownload/Macindroidon the phone. - Photos and screenshots you take on the phone pop up under the menu‑bar icon for a few seconds (longer while the pointer is on them). Copy puts the full‑size picture on the clipboard, Save puts it in Downloads, and you can drag it into any app or click it to open it in Preview. Turn it off in Settings → Show New Photos from Phone.
- Send a link from the phone with Share → Macindroid; it opens in your Mac's browser. From the Mac, choose Open Safari Tab on Phone (or Chrome, Edge, Brave, Arc, Vivaldi) while the browser is in front.
- Paste a code: ask a website for a sign‑in code, and when it arrives on the phone, press ⌘V on the Mac. A quiet notice shows which code was copied; click it to copy the code again. Turn this off with Settings → Copy Codes from Phone.
- Reply to a message straight from the notification on the Mac.
- Calls: when the phone rings, a card drops down from the menu‑bar icon. Answer picks the call up on the phone (on its speaker or headset; Android doesn't let the Mac carry the sound) and Decline rejects it. To dial from the Mac, tick Settings → Call Phone Numbers I Click: phone‑number links then ask Call …? and your phone places the call. On the phone, allow Phone calls on the Calls row so it dials straight away; without it you get a notification that opens the dialer with the number filled in.
- Show Phone in Finder mounts the phone as a disk named after it. The first time, the phone asks you to allow access to all files. Finder shows its size as unknown; copying works normally. It unmounts when the phone has been gone for a minute.
- Lock Mac When Phone Leaves (in Settings, off until you tick it) locks the Mac about 40 seconds after the phone leaves the Wi‑Fi network or is switched off. It goes by whether the phone's address still answers on the network, not by the app's link, so a phone asleep on the desk never locks you out. It only acts if the phone was connected since you last unlocked, so a Mac used without the phone is left alone. It can't tell when you walk to another room on the same Wi‑Fi.
- Mirror Phone opens your phone in a window. Clicking a phone notification on the Mac also opens it there.
- Shortcuts:
macindroid://ring,macindroid://stop-ring,macindroid://mirror,macindroid://files,macindroid://menu,macindroid://power-setupandmacindroid://phone-appwork from Shortcuts, Spotlight, Raycast oropen. There's deliberately no link for sending files, since any web page can open a link.
- Nothing leaves your network. The Mac listens on port 47800 and announces itself on your Wi‑Fi with Bonjour
(
_macindroid._tcp); the phone connects to it directly. There's no account, server or analytics. The one exception: once a day the Mac asks GitHub whether there's a newer Macindroid (an anonymous request for the latest release, nothing sent about you); turn it off with Settings → Check for Updates. Updates to the phone app come from the Mac, so the phone never checks. - Your files stay between the two. Finder reaches the phone's files through a small server inside the Mac
app that listens only on the Mac itself (127.0.0.1), behind a password made up at each launch, and passes every
request to the phone over the encrypted link. The phone opens nothing on the network for it, and nothing is kept
on the Mac. Finder's own bookkeeping files (
.DS_Store,._name) stay on the Mac. - Calls and numbers aren't logged. Who is calling and what you dialled never go in a log on either device. A phone‑number link always asks before dialling, since any web page can carry one.
- A sleeping Mac is left asleep. Before it sleeps the Mac tells the phone and stops listening, so the phone doesn't keep waking it. When you open the Mac again it sends the phone one small encrypted "I'm back" message and the two reconnect within a second or so.
- Pairing you can check. The two devices agree a key with X25519. Both screens show a six‑digit code derived from that key, so a device in the middle would show a different code. Everything after that is encrypted and authenticated with AES‑256‑GCM, using a key derived with HKDF‑SHA256.
- Secrets stay put. Copies a password manager marks as concealed on the Mac (nspasteboard.org types, used by 1Password, Bitwarden and others) or as sensitive on Android are never sent. Notifications an app marks as secret aren't forwarded, and while you're using the phone nothing is, except one‑time codes.
- One‑time codes, handled like passwords. Android 15 and later replace codes in notifications with
Sensitive notification content hidden for apps that read notifications, unless the app is a companion app
you've linked to a device of yours, as a watch app is. One‑time codes → Allow links Macindroid to your Mac in
Android's own pairing dialog, and uninstalling Macindroid removes the link.
(On phones that allow it, the power‑features setup also sets the
RECEIVE_SENSITIVE_NOTIFICATIONSapp op, which does the same.) The phone looks for a 4–8 character code next to a word such as code, OTP, verification or PIN (in about 30 languages) and skips amounts, dates, times, phone numbers, card endings, order numbers and promo codes. Only the code, the sender and the app's name go to the Mac. There it is marked concealed and transient for clipboard managers, so they don't store it and Macindroid doesn't send it back, cleared after two minutes unless you've copied something else, and the notice showing it is removed at the same time. Neither app ever writes a code to its log. - Small permissions, explained.
READ_LOGSlets the phone see the one line Android writes each time an app is denied the clipboard. Android 10 and later stop background apps from reading the clipboard, so Macindroid watches for that line and then reads the clipboard through an invisible 1×1 window.WRITE_SECURE_SETTINGSswitches wireless debugging on only for the length of a mirroring session. - Photos stay on the phone until you want them. Only new camera photos and screenshots, taken while the two are connected, are offered, as a preview about 720 pixels across. The original crosses only when you copy, save, drag or open it, and the Mac can ask only for a photo it was offered. Pictures saved from chat apps, downloaded or synced from the cloud are left alone.
- Where things live. On the Mac: the pairing key in
~/Library/Application Support/Macindroid(readable only by you) and a log in~/Library/Logs/Macindroid.log.
The menu says "Looking for your phone · same Wi‑Fi?"
Check that both are on the same Wi‑Fi network, and not a guest network: guest networks often keep devices from seeing each other. On the Mac, check System Settings → Privacy & Security → Local Network → Macindroid is on. The phone reconnects by itself within seconds of the Mac coming back, even with its screen off: the Mac tells it when it wakes. If that message is lost, the phone still checks every few minutes, and waking the phone reconnects it at once.
Copies on the phone don't reach the Mac
Android asks again for log access after the phone restarts or Macindroid updates, and only while Macindroid is on screen. When that's needed, Macindroid's notification on the phone says Copies on this phone aren't reaching your Mac: tap it, then tap Allow. If the Clipboard row says Set up power features, see power features.
Codes don't reach the Mac's clipboard
Check Settings → Copy Codes from Phone is ticked. If the Mac shows the phone's notification as Sensitive
notification content hidden, Android is hiding the code from Macindroid: open Macindroid on the phone and tap Allow
code access under One‑time codes. If your Mac isn't listed, open System Settings
→ Bluetooth on the Mac and try again. With the phone plugged in, adb logcat -d -s Macindroid | grep "one-time codes" says whether codes are visible. A code only counts
as one if a word like code or OTP is near it, so a message that's only a number isn't copied.
Mirror Phone doesn't start
Over Wi‑Fi, mirroring needs the power features once, so the phone can switch on Wireless debugging by itself. Plugged in with USB debugging on, it starts straight away.
Phone notifications don't appear on the Mac
Check System Settings → Notifications → Macindroid. While a Focus is on, they go quietly to Notification Center. They're also held back while you're using the phone, which is on purpose.
macOS says Macindroid "can't be opened"
See On the Mac. You can check your download against SHA256SUMS from the release:
cd ~/Downloads && shasum -a 256 -c SHA256SUMS --ignore-missing.
No Xcode project and no Gradle. The Mac app bundles scrcpy's own macOS build (with adb) for mirroring and the phone setup; everything else is about 4,600 lines of Swift (AppKit, Network, CryptoKit) and a Java app built with the plain Android SDK tools.
git clone https://github.com/iamkhalid2/macindroid.git && cd macindroid
./mac/install.sh # builds Macindroid.app into ~/Applications and starts it at login (Xcode command line tools)
./setup-phone.sh # builds the APK and installs it over USB (Android SDK with build-tools, JDK 17 or later)
./release.sh # builds both and writes the disk image, APK and checksums to dist/ (first run installs dmgbuild)./release.sh --publish also tags v + the version in VERSION and publishes the GitHub release, with notes made
from the commits since the last one. It refuses unless everything is committed and pushed and the version is new,
then checks the published checksums against what it built. Installed copies pick the release up within a day. It
runs on your Mac, not in CI, so the signing key never leaves it.
The first Android build creates a signing key in ~/.android/macindroid.keystore and records its password in
android/signing.env, which git ignores. Keep both: an update signed with a different key won't install over the
app.
android/test.sh checks the one‑time‑code finder against 117 example messages (codes in about 30 languages, and
messages full of numbers that aren't codes) using plain Java, no phone needed. android/test.sh --phone runs the
same set on a connected phone too, on Android's own runtime, whose regex engine differs from desktop Java's.
To test the Mac app without a phone, cd mac && uv run --with cryptography python3 test_client.py plays the
phone's part against the running app: ping, a 3 MB file arriving byte‑identical, a corrupted file discarded with
nothing left behind, the phone app's update, notifications cleared on either side (and while apart) being cleared
on the other, a ringing call and its buttons, a clicked number being dialled, the phone mounted as a real volume
(macOS's own file client reading, copying in, renaming and deleting against a folder standing in for the phone),
the link closing for sleep and reopening on wake, a phone that vanished being noticed, the lock when the phone
leaves (it only writes that it would lock), and a wrong key refused. It takes about two minutes, and your real
phone is off the link while it runs.
Measured with a MacBook Air and an Oppo Find X9, connected and idle (version 1.0):
| CPU | Wake‑ups | Memory | |
|---|---|---|---|
| Mac app | 0.0 % (macOS energy impact 0.0–0.1) | about 1 a second | 35 MB |
| Phone app | 0.4 % of one core, screen on | a ping every 25 s | 69 MB |
On the Mac, quit Macindroid from its menu, move it to the Trash, and remove its files:
rm -rf "$HOME/Library/Application Support/Macindroid" ~/Library/Logs/Macindroid.logIf you installed with mac/install.sh, also run
launchctl bootout gui/$(id -u)/xyz.iamkhalid.macindroid; rm ~/Library/LaunchAgents/xyz.iamkhalid.macindroid.plist.
On the phone, go to Settings → Apps → Macindroid → Uninstall, or run adb uninstall xyz.iamkhalid.macindroid.
MIT. scrcpy and adb, bundled in the Mac app for mirroring and the phone setup, are separate projects
under the Apache License 2.0; scrcpy's licence is in Macindroid.app/Contents/Resources/scrcpy/LICENSE.





