Install ADB

SuperMirror uses ADB (Android Debug Bridge) to communicate with your Android device over USB. You need to install it once on your Mac.

Option 1: Homebrew (recommended)

If you have Homebrew installed:

brew install android-platform-tools

This works on both Apple Silicon and Intel Macs. It installs adb to:

Apple Silicon: /opt/homebrew/bin/adb
Intel: /usr/local/bin/adb

Option 2: Manual download

Download Android SDK Platform Tools for macOS
Unzip the download
Move the platform-tools folder somewhere permanent (e.g., ~/Library/Android/platform-tools)

Add it to your PATH:

# Add to ~/.zshrc
export PATH="$HOME/Library/Android/platform-tools:$PATH"

Restart your terminal

Verify installation

adb version

You should see something like:

Android Debug Bridge version 1.0.41
Version 35.0.2-12147458

SuperMirror can also use a bundled copy of ADB if you don't have it installed. But installing it system-wide is recommended — it stays up to date and works with other Android tools.

macOS security prompt

The first time you run adb, macOS may show a prompt: "adb" is from an unidentified developer. or ask to allow incoming network connections.

If blocked: go to System Settings → Privacy & Security and click "Allow Anyway"
If asked about network connections: click "Allow" — ADB needs a local server

Next steps

Once ADB is installed, you need to enable Developer Mode on your Android device.