Skip to main content
Phones are connected to your Mac, and Appeeky Desktop shares them with Appeeky. Agents can only reach a phone while Appeeky Desktop is running, you are signed in and sharing is on.

Share phones from Appeeky Desktop

  1. Open Appeeky Desktop and sign in with your Appeeky account.
  2. Go to Settings → Phones.
  3. Turn on Share phones with Appeeky.
Sharing is off by default. The setting is remembered, so sharing starts again the next time you open the app. The badge next to the switch shows the connection: Open phones and approvals opens the Phones page of the web dashboard.
Phones belong to the account that is signed in to Appeeky Desktop. API keys and MCP sessions of the same account can use them. Other accounts can’t.
You can connect several phones to one Mac, and share phones from more than one Mac. Each Mac appears with its own name on the Phones page.

Android

1

Turn on USB debugging

On the phone, open Developer options and turn on USB debugging.
2

Connect it by USB

Connect the phone to the Mac with a cable and tap Allow on the phone when it asks.
3

Keep it unlocked

A locked screen stops the agent.
Android emulators are detected automatically. Appeeky Desktop talks to Android phones with adb. It looks for it in the Android SDK (~/Library/Android/sdk/platform-tools, or the folder set in ANDROID_HOME or ANDROID_SDK_ROOT) and then on your PATH. If adb is not installed, no Android phone is found.
Typing plain English text works out of the box. Text with accents, non-Latin letters or emoji needs a helper keyboard app on the phone. When it is missing, the action fails with a message that tells you what to install.

iPhone

1

Install Xcode and sign in

Install Xcode on the Mac. In Xcode, open Settings → Accounts, sign in with your Apple ID, then choose Manage Certificates → + → Apple Development. A free personal team works.
2

Turn on Developer Mode

On the iPhone, open Settings → Privacy & Security → Developer Mode and turn it on.
3

Connect it by cable

Connect the iPhone to the Mac, unlock it and tap Trust when it asks.
4

Wait for the helper app

Appeeky Desktop builds a small helper app, WebDriverAgent, with Xcode and starts it on the iPhone. The Phone page shows Preparing your iPhone with the current step. The first time takes a few minutes. Later starts are faster because the build is reused.
5

Trust the developer on the phone

If the helper does not start on the first run, open Settings → General → VPN & Device Management on the iPhone and trust your developer certificate.
The iPhone appears in the list once the helper app is running. If you already run WebDriverAgent yourself on port 8100, Appeeky Desktop uses it and does not start its own.
Forwarding the connection to the iPhone uses the iproxy tool. If it is missing, the setup log says so and tells you to install it with brew install libimobiledevice.

What works on each platform


Check the connection

Open /dashboard/phones. The Connected section lists each Mac with an online badge, how long it has been connected, and its phones with their platform.
  • No phones connected means no Mac is sharing. Open Appeeky Desktop and check Settings → Phones.
  • No phones on this Mac right now means the Mac is online but found no phone. Setup problems are listed under the Mac, for example iOS: Alex's iPhone: Developer Mode is off. Turn it on: Settings > Privacy & Security > Developer Mode.
New and removed phones show up on their own. In Appeeky Desktop, the Phone page has a refresh button and an Add a phone help box. See Troubleshooting if a phone does not appear.