ZeptapSet up an iPhone
The first-run assistant, step by step - permissions, USB and Trust, screen check, Bluetooth pairing and agent connectors.
The setup assistant opens on first launch. Run it again any time from Settings (⌘,) › Preferences › Run setup again. Each step advances on its own once its condition is met.
Grant Mac permissions
Allow Camera (to see the iPhone screen over USB) and Bluetooth (to tap and type on it). macOS remembers both for Zeptap.
Plug in the iPhone and tap Trust
Connect the iPhone with a USB cable and unlock it. When the iPhone asks Trust This Computer?, tap Trust and enter the passcode.
Over USB, Zeptap reads the iPhone's name, model and Bluetooth address, so the phone on the cable is the phone it controls. It also turns AssistiveTouch on if it is off.
Check the screen
Keep the iPhone plugged in and unlocked while Zeptap confirms it can see the screen. The step completes when the live mirror shows the iPhone's screen.
Pair over Bluetooth
If Bluetooth is off on the Mac, Zeptap offers to turn it on. Then, on the iPhone:
- Open Settings › Bluetooth.
- Tap this Mac's name under Other Devices.
- If the Mac asks to pair, click Connect on the Mac and Pair on the iPhone.
The step completes when Zeptap shows Connected to the iPhone and can move the pointer. This is the only step done on the iPhone, and it is needed once per iPhone.
Add Zeptap to your agents
Zeptap lists the supported agents installed on this Mac. Click Add for each one you use. See Connect an agent for what each button changes and for manual setup.
Recommended iPhone settings
These are optional, and make agent runs steadier:
| Setting on the iPhone | Why |
|---|---|
| Settings › Display & Brightness › Auto-Lock › Never | The screen stays on through long agent runs. Zeptap can also keep the screen awake from its own settings |
| Settings › Accessibility › Touch › AssistiveTouch, turn off Always Show Menu | Hides the AssistiveTouch button so it covers less of the screen |
To let agents unlock a locked iPhone, save its passcode in Zeptap: see Lock and unlock.
Add another iPhone
Choose Pair a New iPhone… from Settings › Phones, then plug the new iPhone in and follow the same steps. Zeptap controls the iPhone that is on the USB cable.