> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appeeky.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect phones

> Set up Android phones and iPhones on your Mac and share them with Appeeky from Appeeky Desktop.

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:

| Badge | Meaning |
| - | - |
| **Connected** | Your Mac is online and agents can use its phones |
| **Connecting…** | The connection is being opened |
| **Reconnecting** | The connection dropped. The reason and the time until the next try are shown below. Appeeky Desktop keeps retrying, waiting up to 30 seconds between tries |
| **Unavailable** | Sharing could not start. The reason is shown below |
| **Off** | Sharing is turned off |

**Open phones and approvals** opens the **Phones** page of the web dashboard.

> [!NOTE]
>
> 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.

> [!TIP]
>
> 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.

> [!NOTE]
>
> 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

| | Android | iPhone |
| - | - | - |
| Observe, tap, long press, swipe, scroll, type | Yes | Yes |
| Open an app, list apps | Yes | Yes |
| Push media to the gallery | Yes | No |
| Keys | `home`, `back`, `enter`, `delete`, `app_switch`, `volume_up`, `volume_down`, `lock` | `home`, `enter`, `delete`, `lock`, `volume_up`, `volume_down` |

***

## 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](https://docs.appeeky.com/docs/phones/troubleshooting.md) if a phone does not appear.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.