如何将 Twitter/X 收藏夹同步到 Apple TV 播放

用 XTTV 这个应用，通过 Twitter 授权登录后，一键同步你的 Bookmark 收藏视频，就能在 Apple TV 和 Android TV 上用大屏幕看所有收藏的内容了。

为什么需要这个功能？

Twitter（现在叫 X）的 Bookmark 是个挺实用的功能，可以把想看的推文先存起来。但问题是，X 官方没有出过电视版应用，所以这些收藏的视频只能在手机上小屏幕看，体验确实不太好。

我自己就是重度 Twitter 用户，每天刷到有趣的视频就顺手收藏，但回头想在大屏幕上舒服地看时，发现根本没官方方案。这也是我做 XTTV 的初衷之一——把收藏的视频搬到电视上。

XTTV 是怎么工作的？

XTTV 本质上是一个播放器，不生产内容，只是帮你把在 X 上收藏的视频以更友好的方式在电视上播放出来。

登录方式

Apple TV 遥控器打字确实不太方便，所以我用了 OAuth 2.0 的设备授权流程：

电视上会显示一个授权链接或二维码
用手机或电脑浏览器打开这个链接
在浏览器里登录 Twitter 并授权
授权完成后，电视端自动刷新并加载内容

这样避免了在电视上输密码的糟糕体验。另外，应用只申请读取权限，不会发推文、不会点赞评论，最大限度保护账号安全。

同步逻辑

后端做了一些优化来提高同步效率：

第一次同步会拉取最近的收藏，只保留含视频的条目
后续同步只检查新增的内容，避免重复拉取
Token 会自动续期，不用重复登录
如果收藏的是引用了视频的文字推文，会自动追溯到原始视频

实际测试下来，用户收藏的推文里大概 30-40% 包含视频或引用视频。系统会自动过滤掉纯文字和图片推文，只留下能播放的视频。

电视端界面

同步完成后，电视上会显示一个视频网格：

有缩略图、作者信息、播放时长
用遥控器上下左右选择，按播放键就能看
支持断点续播，中断后可以从上次位置继续
分页加载，几百条收藏也能流畅浏览
随时可以点同步按钮获取最新收藏

具体怎么设置

第一步：安装并启动 XTTV

Apple TV：在 Apple TV 4K（tvOS 18.2+）上装好应用，启动后进入应用。
Android TV：在电视上安装 XTTV Android TV APK。

第二步：获取授权链接

进入“收藏夹 / Bookmarks”标签页，应用会显示一个 Twitter OAuth 授权 URL 和二维码。

第三步：在手机上完成授权

用手机扫码，或在浏览器里打开链接，登录 Twitter/X 账号并点击 "Authorize app" 授权。

第四步：回到电视刷新状态

按遥控器上的 Play/Pause 键，或者点"刷新授权状态"，应用会自动检测登录完成并加载内容。

第五步：进入收藏夹同步

导航到收藏夹（Bookmarks）标签页
点同步按钮
等几秒钟，系统会自动过滤并展示所有含视频的收藏推文

其他功能

多平台支持

XTTV 目前已支持 Apple TV 4K（tvOS 18.2+）和 Android TV 8.0+。两个版本共用同一套后端服务，账号数据互通。界面支持中文、英文、日文、西班牙文、德文、法文、韩文切换。

List 同步

除了 Bookmark，还可以同步你关注的 Twitter List 时间线，或者用热门搜索关键词快速发现内容。

隐私和安全

Token 存在系统的安全 Keychain 中
API 密钥不会暴露在客户端，通过后端中转
只申请必要的读取权限

常见问题

同步后有些收藏没显示，为什么？
XTTV 只显示包含视频的收藏推文。纯文字、只含图片、或者视频已被删除的推文会被过滤掉。

需要付费吗？
基础搜索和浏览功能免费。Bookmark 同步和 List 同步是高级功能，Beta 早鸟价为 $1.99/月。

可以在多台电视上用同一个账号吗？
可以。只要用同一个 Twitter 账号登录，不同设备间的收藏内容是同步的。