告别电视广告首页:开源项目couch-tv让你的Google TV变身无广告自定义主屏幕
告别电视广告首页:开源项目couch-tv让你的Google TV变身无广告自定义主屏幕
couch-tv 是一个免费的开源项目,它为 Google TV / Android TV 提供无广告自定义主屏幕和手机遥控器:用 5 个轮换的风景背景加玻璃时钟取代广告首页,应用按你自己的顺序排列,还自带跨应用的"继续观看"和能按名字找片开播的手机遥控器。
📺 couch-tv 能做什么:告别广告首页的核心亮点
- 无广告主屏幕:Night、Golden、Waterline、Fog、Dawn 五个场景每 20 秒轮换,另有 Classic 经典样式;还能换成自己的照片,甚至自己设计场景
- 玻璃时钟 + 天气:大号时间悬浮在风景之上,旁边显示当地天气
- Keep watching(继续观看):最多 10 部看到一半的剧,按人区分、最新的在前
- 手机遥控器:方向键、音量、输入、电源键一应俱全,还能打字
- 按名字找片开播:说一句"put on Bluey",它自动查出这部剧在哪个平台流媒体播出,直接打开对应应用开播,还会替你跳过"谁在看"的选人画面
- 可选 Claude 助手:问"放个搞笑的",它帮你挑
- 儿童模式:孩子专属首页,只有你选定的剧集和允许的应用,退出要家长 PIN
- TV 端设置:语言、位置、外观、应用顺序都在电视上直接改,不用碰电脑
此外还有 Now playing 音乐卡片、快捷按钮(睡眠定时器、画质模式、信号源)、Home Assistant 智能家居卡片、10 种语言、双电视同步播放(实验性)等。完整功能见 docs/TV-HOME.md。
你的电视支持吗?快速检查方法
couch-tv 在 Google TV / Android TV 上功能最完整,Samsung、LG、Roku、Apple TV、Fire TV 等也有不同程度的支持。注意官方提醒:"看的是型号,不是品牌"——打开电视的 Settings → System → About(或 Device Preferences → About),显示 Android TV OS 就没问题。
| 电视 | A. 仅主屏幕 | B. 电脑桥接 | C. 免电脑 |
|---|---|---|---|
| Google TV / Android TV | ✅ | ✅ | 部分支持 |
| Fire TV(Fire OS) | 部分 | 部分 | 部分 |
| Samsung(Tizen) | 仅应用 | 应用模式 | 不支持 |
| LG(webOS) | 仅应用 | 应用模式 | 不支持 |
| Roku | 仅应用 | 频道模式 | 不支持 |
| Apple TV | 不支持 | Beta | 不支持 |
完整对照表见 docs/PLATFORMS.md。小贴士:如果你的电视不是安卓系,插一个 Google TV 盒子(如 Google TV Streamer)就能用上完整功能。
不改电视、也不安装任何东西的自检方法,在同一 Wi-Fi 下运行:
python3 scripts/find-tvs.py # 列出 Wi-Fi 里的电视
python3 scripts/check-tv.py <电视地址> # 告诉你这台电视支持哪种运行方式
对应源码:scripts/find-tvs.py、scripts/check-tv.py。
三种运行方式,按需选择
| A. 仅 TV 主屏幕 | B. 电脑桥接 | C. 免电脑,活在电视上 | |
|---|---|---|---|
| 你得到 | 新主屏幕,用原装遥控器 | 主屏幕 + 手机遥控器 + 找片 + 可选 AI 助手 | 主屏幕 + 手机遥控器,bridge 跑在电视应用里 |
| 需要常开的电脑 | 否 | 是(Mac / Linux / 树莓派) | 否 |
| 文档 | docs/SETUP.md | docs/SETUP.md | on-tv/README.md |
最快安装方法:把仓库交给 AI agent
最省事的方式是把仓库直接交给 AI 编程 agent(如 Claude Code):
git clone https://gitcode.com/gh_mirrors/co/couch-tv
cd couch-tv
用 agent 打开这个文件夹,说一句 "set this up on my TV" 即可。它会读取仓库里的 AGENTS.md,自动找到你的电视,问几个问题(谁在看、什么风格、留哪些应用),把方案复述给你,并在你说"yes"之前不改动电视上的任何东西。
手动安装也不复杂(选 A 只需 1、2、4 步):
- 开启开发者模式:电视上 Settings → System → About,连续按 Android TV OS build 7 次解锁 Developer options,打开 USB debugging / Network debugging(ADB)
- 准备电脑环境(Python 3.11+):
python3 -m venv .venv后安装 bridge/requirements.txt,并把 config.example.json 复制为config.json填入电视地址、家人和位置 - (仅 B)配对并启动 bridge:
python bridge/pair_tv.py <电视名>输入电视上显示的代码;cd remote && npm ci && npm run build构建手机遥控器;再运行python bridge/server.py - 把主屏幕装上电视:从项目 Releases 下载
couch-tv-home.apk,然后:
TV_IP=<电视地址> APK=couch-tv-home.apk sh tv-home/tools/apply.sh
装好后按 Home 键就是你的专属首页了。放心:它不会删除或关闭 Google 原首页,只会关掉 ambient 待机广告和广告跟踪,随时可撤。每一步的完整细节在 docs/SETUP.md。
📱 手机遥控器:一句话开播
手机遥控器是 bridge 提供的一个小网页,无需去应用商店下载:手机连上同一 Wi-Fi,浏览器打开 http://<你的电脑>:5400,点"添加到主屏幕"即可。
Remote 页是传统遥控器(方向、音量、Home、电源),Watch 页是继续观看 + 你的应用,底部输入框直接说想看的剧。安全提醒:bridge 只服务家庭网络,永远不要把 5400 端口转发到公网。详见 docs/REMOTE.md。
儿童模式 + TV 端设置,都在这台电视上完成
儿童模式默认关闭,开启后孩子的首页只剩一栏你挑好的剧(大海报直接点开),下面是你允许的应用,没有应用商店、没有设置入口、没有别人的观看记录,右上角"成人"入口要输 家长 PIN 才能出去。
日常设置则不用电脑:应用栏最右的齿轮(或遥控器设置键)里,可以直接改语言、天气位置、外观与场景、应用和顺序、家庭成员和快捷按钮。
🛡️ 隐私与安全:数据不出家门
- 设置(
config.json)、观看历史与推荐都存在你自己的电脑和电视上(bridge/data/),不会上传 - 可选 Privacy clean:
PRIVACY=1时apply.sh会顺手关掉它发现的已知跟踪 / 广告 / ACR 应用,且可逆,详见 docs/PRIVACY.md - 项目自带隐私扫描脚本,检查是否会泄露家庭地址、邮箱、Wi-Fi 名等:scripts/privacy-scan.sh
- 手机遥控器默认无密码,家人(包括孩子)都能用;访客建议放访客 Wi-Fi,或在
config.json设置pairing_key
不想用了?随时把 Google 首页装回去
couch-tv 从不删除或禁用原首页,所以撤销很简单:先停掉 bridge,再运行 tv-home/tools/remove-all.sh(加 DEV_OFF=1 可连开发者模式一起关);只有一台电视遥控器也能还原,步骤都写在 docs/UNINSTALL.md。
同一套首页,点亮多块屏幕
同一个 home 也能以原生应用跑在 Apple TV(Beta)、以频道跑在 Roku、装进 Fire TV Stick、Samsung、LG:
延伸阅读
- 安装全步骤:docs/SETUP.md · Docker 部署:docs/DOCKER.md
- 主屏幕全部功能:docs/TV-HOME.md · 所有配置项:docs/CONFIG.md
- 电视兼容性:docs/PLATFORMS.md · 品牌对照:docs/TV-BRANDS.md
- 工作原理与隐私:docs/HOW-IT-WORKS.md · 卸载指南:docs/UNINSTALL.md
- 代码结构:电视主屏幕在 tv-home/,手机遥控器在 remote/,桥接服务在 bridge/








