corvofeng / atv-core

# Fake Apple TV (atv-core) 📺
> **English Version** | 中文版本
**Turn the Apple TV Remote that's already built into your iPhone into a controller for Android TV and Mac.** Pull down Control Center, pick your device, and start navigating — no jailbreak, no third-party app, no extra hardware.
### iPhone: Find the Remote and Start Using
Swipe down from the top-right corner to open Control Center, tap "Apple TV Remote", select the device running the receiver, pair it, and you're ready to swipe and click.
| **Find the Remote** | **Use the Remote** |
| :---: | :---: |
| | |
| **Swipe down from top-right** to open Control Center, tap the circled remote icon *(If missing, go to **Settings → Control Center** to add it)* | Touchpad on top for swipes / cursor navigation Buttons below for Select, Back, Play/Pause, Volume, etc. |
📖 Full walkthrough & demo: Blog Post
---
## Download
Prebuilt binaries are attached to the latest release:
| Platform | Download |
| :--- | :--- |
| macOS (Apple Silicon) | `AppleTVRemote-arm64.dmg` |
| macOS (Intel) | `AppleTVRemote-x86_64.dmg` |
| Windows (x86_64) | `AppleTVRemote-windows-x86_64.zip` / `.exe` |
| Android TV / Google TV | `FakeAtv-release.apk` |
Prefer to build it yourself? See Build from source.
---
## Compatibility
| | Supported | Notes |
| :--- | :--- | :--- |
| **Controller** | iPhone / iPad with the native **Apple TV Remote** in Control Center | No app install needed on the phone |
| **macOS targets** | Apple Silicon & Intel Macs (menu bar app + CLI) | Requires Accessibility permission |
| **Android targets** | Android TV, Google TV, TV boxes, emulators | Requires network ADB; see limitations |
| **Network** | Controller and target on the same LAN | AP isolation / guest Wi-Fi must be off |
**Tested on** :
- iOS / iPadOS: _to be listed_
- macOS: _to be listed_
- Android TV devices: _to be listed_
### Limitations
- **Android TV needs network ADB.** Android blocks ordinary apps from injecting D-pad / Select keys into other apps, so key injection relies on a local ADB channel. The Accessibility Service is only a fallback and handles global actions (Back / Home). Full setup: Android TV prerequisites.
- **Pairing uses a fixed PIN.** When the iPhone asks for a pairing code, enter **`1111`**.
- The macOS app is signed with a self-signed certificate, so Gatekeeper will warn on first launch. See macOS prerequisites.
---
## Quick start
1. **Install** the DMG (Mac) or APK (Android TV) from Download.
2. **Put your iPhone and the target on the same Wi-Fi** (AP isolation off).
3. **Grant permissions** — Accessibility on macOS; network ADB + the on-screen "Always allow" prompt on Android TV. Details below.
4. **Open Control Center to find the Remote**:
 - Swipe down from the top-right corner of your screen to open **Control Center**, then tap the circled **Apple TV Remote** icon.
 - *(If the icon is not in Control Center, go to iOS **Settings → Control Center** and add "Apple TV Remote" from "More Controls")*.
 - Select your target