corvofeng/atv-core

这是什么？

核心功能

• 01直接使用 iPhone 控制中心内置的 Apple TV 遥控器，手机端无需安装应用。
• 02通过本地 ADB 注入按键控制 Android TV 和 Google TV，无障碍服务作为备用方案。
• 03提供 macOS 菜单栏应用和命令行工具，支持平滑光标移动和媒体按键。
• 04提供 Windows 系统托盘版本，附带本地网页控制台用于调整触控板设置。
• 05内置网页调试器和诊断页面，便于排查触控手势和协议会话问题。

适用场景

• 不额外购买遥控器，用 iPhone 操控 Android TV 或 Google TV 盒子。
• 在沙发上用 iPhone 遥控器控制 Mac 的光标和媒体播放。
• 在 Android Studio 模拟器中测试 Apple TV 遥控器协议的交互效果。

快速上手

1. 1

   从下载页安装 Mac 的 DMG 或 Android TV 的 APK

2. 2

   将 iPhone 与目标设备连接同一 Wi-Fi，并关闭 AP 隔离

3. 3

   授予权限：macOS 上开启辅助功能，Android TV 上开启网络 ADB 并在弹窗中选择始终允许

4. 4

   在 iPhone 上打开控制中心，点击 Apple TV 遥控器图标，选择目标设备并输入 PIN 1111

使用前须知

• !Android TV 需要开启网络 ADB，并在电视上确认 RSA 授权弹窗。
• !macOS 应用使用自签名证书，首次启动时 Gatekeeper 会显示警告。
• !控制端与目标设备必须位于同一局域网，并且需要关闭 AP 隔离。
• !仓库元数据未列出许可证，但 README 提到 MIT 许可证。

标签

常见问题

atv-core 是什么？

让 iPhone 控制中心自带的 Apple TV 遥控器可以操控 Android TV、Google TV 和 Mac。 atv-core 是一个接收端程序，让 Android TV、Google TV 和 macOS 设备在 iPhone 或 iPad 的原生 Apple TV 遥控器中显示为 Apple TV 目标。用户打开控制中心，选择设备并输入 PIN 码 1111，即可通过触控板滑动、移动光标，并用按钮完成确认、返回、播放暂停和音量调节，手机上无需安装任何应用。

atv-core 可以免费使用吗？用的什么许可证？

atv-core 没有声明许可证。代码虽然公开，但没有许可证就没有明确的使用授权，正式使用前建议先联系作者。

atv-core 还在维护吗？

活跃维护中。atv-core 最近一次提交是在 2026年10月7日。

atv-core 适合用来做什么？

不额外购买遥控器，用 iPhone 操控 Android TV 或 Google TV 盒子。 在沙发上用 iPhone 遥控器控制 Mac 的光标和媒体播放。 在 Android Studio 模拟器中测试 Apple TV 遥控器协议的交互效果。

atv-core 怎么安装和运行？

从下载页安装 Mac 的 DMG 或 Android TV 的 APK 将 iPhone 与目标设备连接同一 Wi-Fi，并关闭 AP 隔离 授予权限：macOS 上开启辅助功能，Android TV 上开启网络 ADB 并在弹窗中选择始终允许 在 iPhone 上打开控制中心，点击 Apple TV 遥控器图标，选择目标设备并输入 PIN 1111

在哪里获取 atv-core？

源代码和安装说明在 GitHub 上：https://github.com/corvofeng/atv-core