# Apple TV

Start, mirror and control Apple TV simulators on tvOS 27 in Device MCP, with a Siri Remote on your keyboard, and let your AI agent test your tvOS app with the same MCP tools.

Device MCP mirrors and controls Apple TV simulators the way it does an iPhone simulator: in the same sidebar, in their own frame, and with the same MCP tools for your AI agent. An Apple TV has no touchscreen, so Device MCP gives you and your agent its Siri Remote instead. Nothing is installed in the simulator.

## 1. Requirements

* **Xcode** on your Mac, with a **tvOS 27** simulator runtime. Add one in **Xcode → Settings → Components**.
* Apple TV simulators on tvOS 27 or later: Apple TV 4K, at 4K or at 1080p.
* Apple TV simulators only. Device MCP doesn't mirror a real Apple TV.

## 2. Start an Apple TV simulator

1. Click **+** at the top of the sidebar, then choose **New Simulator → Apple TV** and a model.
2. Click **Start**. Device MCP boots the simulator and shows its screen as soon as it's up.

Apple TV simulators are listed, started and shut down like iPhone simulators, with a TV icon in the sidebar. See [iOS Simulator](ios-simulator.md#2-start-a-simulator).

{% hint style="info" %}
Device MCP Free mirrors one device at a time, and an Apple TV simulator counts as one. Device MCP Pro mirrors any number. See [License](../license.md).
{% endhint %}

## 3. Mirror and control

* **The TV it plays on**: the mirror is drawn as Xcode's Device Hub draws it, a thin bezel on a stand, lossless at the TV's resolution (3840 × 2160 at 4K, 1920 × 1080 at 1080p).
* **Mouse and trackpad**: a click on the mirror is **Select**. A drag or a two-finger scroll moves the focus, the way content would scroll.
* **Keyboard**: the arrow keys move the focus, <kbd>Return</kbd> is **Select** and <kbd>Esc</kbd> is **Menu**, as on a TV.
* **Remote buttons**: the toolbar has **Menu** (back), **Home** (the TV button) and **App Switcher**. The **Device** menu adds **Select**, **Play/Pause** and the arrows. Control Center is in the **…** menu.
* **Screenshots and recording**: see [Screenshots & Recording](../basic-features/screenshots-and-recording.md).

| Remote | On your Mac |
| --- | --- |
| Menu (back) | <kbd>⌘[</kbd> or <kbd>Esc</kbd> |
| TV button (Home) | <kbd>⇧⌘H</kbd> |
| App Switcher (TV pressed twice) | <kbd>⌃⇧⌘H</kbd> |
| Play/Pause | <kbd>⇧⌘P</kbd> |
| Select | <kbd>Return</kbd>, or click the mirror |

## 4. With an AI agent

Your agent uses an Apple TV simulator through the same [MCP](../ai-agents/mcp.md) server as an iPhone. It reads the screen with `list_elements`, which marks the item that has the focus, and drives it with the remote:

* `tap` moves the focus to an element one press at a time, reading the screen after each, then selects it. It says so when the focus can't get there.
* `press_key` presses the arrows (`count` repeats one), and `press_button` presses `select`, `menu`, `play_pause` and `home`.
* `swipe` and `scroll` move the focus, `go_back` presses Menu, and `type_text` types into tvOS's keyboard screen.
* `start_simulator` starts or creates an Apple TV simulator, and `launch_app` opens your app.

### ✅ Example Prompts

* Start an Apple TV 4K simulator and take a screenshot of the Home Screen.
* Open my app on the Apple TV simulator, find the documentary about bees and add it to Up Next.
* On the Apple TV, open Settings and tell me the tvOS version.

## 5. Differences from an iPhone

* **Focus, not touch**: there's no tapping a point on a TV. A tap moves the focus there and selects, so it takes a moment longer.
* **No Rotate, Lock, Siri, Notification Center or Spotlight**: tvOS doesn't have them.
* **No Settings tab, clean status bar or clipboard**: tvOS's simulator doesn't take them. To change a setting, open the TV's own **Settings** app.
* **Starts full**: [slim simulators](ios-simulator.md#6-slim-simulators) are iOS and watchOS only.
