Seagey/couch-tv

项目介绍

couch-tv 用一套无广告的 Android TV 桌面替换 Google TV 默认主屏：轮播场景背景、大号玻璃时钟、天气、自定义顺序的应用栏和「继续观看」。它还包括一个手机网页遥控器和一个跑在家庭电脑上的 Python 桥接服务，通过 Android TV Remote 协议与 ADB 控制电视，实现手机遥控、开机、找片播放，以及可选的 Claude 助手（例如「放那个讲没上过法学院的律师的剧」）。三星 Tizen 和 LG webOS 有单独的安装路径，需要一台常开的电脑，其中 LG 版本只按官方文档实现并做过替身测试，尚未在真机运行。

在 Android TV 和 Google TV 上替换主屏可获得完整功能。Fire TV（Fire OS）只支持装在电视上的应用版本，它会检测到 Amazon 主屏弹出后把 couch-tv 重新盖上去，但 Amazon 主屏仍会闪现。Roku、Apple TV、VIDAA 系统海信以及采用 Vega OS 的新款 Fire TV 棒均不支持。

快速使用

需要一台 Android 9 或更新的 Google TV / Android TV、一台同一 Wi-Fi 下装有 Python 3.11+ 的 Mac 或 Linux 电脑，以及从 Releases 页面 下载的 couch-tv-home.apk。README 建议直接把仓库交给编程代理并说「set this up on my TV」，它会读取 AGENTS.md，先问你的电视型号和三种运行方式中的哪一种。

不用代理时：

1. 在电视上打开开发者选项和 USB 调试，记下电视 IP 地址。
2. 克隆并准备环境：

git clone https://github.com/Seagey/couch-tv.git
cd couch-tv
python3 --version
python3 -m venv .venv
.venv/bin/pip install -r bridge/requirements.txt
cp config.example.json config.json

3. 可以先探测电视支持哪些方式，这一步不会改动电视：

.venv/bin/python scripts/find-tvs.py
.venv/bin/python scripts/check-tv.py <tv address>

4. 在 config.json 中填写 tvs、people、weather 和 country。
5. 方式 A（只要主屏，不留电脑常开）：用电视地址和下载的 APK 安装主屏：

TV_IP=<your tv address> APK=couch-tv-home.apk sh tv-home/tools/apply.sh

方式 B 还要配对桥接、用 Node 20+ 构建手机遥控、运行 bridge/server.py，并在 apply.sh 中加 BRIDGE_URL=http://<computer>:5400。完整步骤见 README 安装部分。

运行 apply.sh 前先看撤销说明：它会关闭 Google TV 主屏和设置向导，部分电视关闭向导后会忘记 Wi-Fi。KEEP_SETUP=1 可以避开这个风险，代价是向导可能仍会抢走 Home 键。

使用约束

电视需为 Android 9+ 且开启开发者选项。Google TV 上替换主屏可能导致部分 Google Home 功能和遥控器 YouTube 键失效，系统更新也可能恢复 Google 主屏；方式 B 由桥接每天检查并重新关闭，方式 A 需要重新运行 apply.sh。桥接只应在家庭网络内运行且没有密码，同一 Wi-Fi 下任何人都能使用遥控和 Claude 助手，官方建议不要把它暴露到公网，访客走访客网络。Claude 找片要求那台电脑已安装并登录 Claude Code，调用 claude -p 时会移除 ANTHROPIC_API_KEY，不会产生 API 计费。观看历史和推荐保存在 bridge/data/，该目录已被 git 忽略。

三星和 LG 需要一台常开电脑，且只有自动打开的应用而非真正主屏；这两个平台拿不到截图和「正在播放」信息，播放操作靠计时完成。桥接自身的提示消息在所有界面语言下仍是英文。项目采用 MIT 许可证，作者不承诺支持未测试过的电视型号。

HotRepo 点评

couch-tv 于 2026 年 11 月 1 日出现在 HotRepo 的 Python 新项目榜中，在该榜单记录的大约一天统计窗口内新增 48 Star，窗口结束时仓库为 177 Star、26 Fork。逐小时采样显示 Star 从 10 月 30 日的 121 缓慢升到 11 月 1 日中午的 177，期间 10 月 31 日有一次从 132 回落到 129 的小幅波动。项目没有记录到 GitHub 全语言日榜名次，可观察到的信号是小型仓库的稳定增长，而非爆发。README 自己统计有 16 个 Fork、其中 6 人的改动被合并进主仓库，对一个创建不久的项目来说这比 Star 更能说明它吸引的是愿意动手改的人，而不只是收藏者。