Get your Apple TV on screen.
让 Apple TV 的画面顺利出现。

What do I need?

• An Apple TV with AirPlay turned on (Settings › AirPlay and HomeKit).
• Your iPhone, iPad or Mac on the same home network as the Apple TV.
• Local Network access allowed for TVScope.

How do I connect the first time?

Open TVScope, choose your Apple TV and tap Show Screen. TVScope shows a 4-digit code; enter it on the Apple TV with the Siri Remote. Pairing happens once. With Auto Connect on, TVScope reopens the last device when you launch it. The Remote pairs separately: the first time you open it, the Apple TV shows a code to type in TVScope.

I can see the Apple TV, but it will not connect

Finding a device and connecting to it are separate steps. Check that you are not on a guest network, a hotspot or an isolated VLAN, and that the router does not use client (AP) isolation. Turn off VPN, TUN or "enhanced" modes in proxy apps such as Clash, Shadowrocket, Surge or Stash, then try again. A plain system proxy is usually fine. No route to host means the connection never reached the Apple TV.

Where is the Local Network setting?

iPhone and iPad: Settings › Privacy & Security › Local Network › TVScope. Mac: System Settings › Privacy & Security › Local Network › TVScope. After you change it, quit TVScope and open it again.

The picture stops when I leave the app

iOS pauses network listening in the background and when the screen locks. Keep TVScope in the foreground while you capture, and turn off Low Power Mode while you test.

Mac: the Apple TV never answers

The Apple TV connects back to your Mac. In System Settings › Network › Firewall › Options, allow incoming connections for TVScope. Tools such as Little Snitch or LuLu can also block it. If the Mac uses Wi‑Fi and Ethernet at the same time, try one of them only.

Where are my screenshots and recordings?

In TVScope's Library. They go to Photos only when you turn on Save to Photos or save an item yourself.

需要准备什么？

• 一台已开启 AirPlay 的 Apple TV（设置 › AirPlay 与 HomeKit）。
• iPhone、iPad 或 Mac 与 Apple TV 连接同一个家庭网络。
• 已允许 TVScope 使用“本地网络”。

第一次怎么连接？

打开 TVScope，选择你的 Apple TV，点按“显示屏幕”。TVScope 会显示一个 4 位代码，用 Siri 遥控器在 Apple TV 上输入即可。配对只需一次；开启“自动连接”后，启动时会自动重新打开上次的设备。遥控器需要单独配对：第一次打开遥控器时，Apple TV 会显示一个代码，在 TVScope 中输入即可。

能看到 Apple TV，但连接失败

发现设备和建立连接是两个步骤。请确认没有使用访客网络、个人热点或被隔离的 VLAN，路由器也没有开启客户端（AP）隔离。请暂时关闭 Clash、Shadowrocket、Surge、Stash 等工具的 VPN、TUN 或“增强模式”后重试，普通系统代理通常没有影响。出现 No route to host 表示连接根本没有到达 Apple TV。

本地网络权限在哪里？

iPhone 和 iPad：设置 › 隐私与安全性 › 本地网络 › TVScope。Mac：系统设置 › 隐私与安全性 › 本地网络 › TVScope。修改后请完全退出 TVScope 再重新打开。

离开 App 后画面中断

iOS 在后台和锁屏时会暂停网络监听。采集时请让 TVScope 保持在前台，测试时建议关闭低电量模式。

Mac：Apple TV 一直没有回连

Apple TV 需要主动连接回你的 Mac。请在“系统设置 › 网络 › 防火墙 › 选项”中允许 TVScope 接收传入连接。Little Snitch、LuLu 等工具也可能拦截。如果 Mac 同时连接了 Wi‑Fi 和以太网，请暂时只保留其中一个。

截图和录制在哪里？

在 TVScope 的“资料库”中。只有开启“存储到照片”或手动存储时，才会写入照片图库。