告别电视广告首页:开源项目couch-tv让你的Google TV变身无广告自定义主屏幕

原创2026-11-14 17:39:211,892 阅读

告别电视广告首页:开源项目couch-tv让你的Google TV变身无广告自定义主屏幕

couch-tv 是一个免费的开源项目,它为 Google TV / Android TV 提供无广告自定义主屏幕和手机遥控器:用 5 个轮换的风景背景加玻璃时钟取代广告首页,应用按你自己的顺序排列,还自带跨应用的"继续观看"和能按名字找片开播的手机遥控器。

couch-tv无广告自定义电视主屏幕:风景背景、玻璃时钟、继续观看与应用栏

📺 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夜间场景自定义主屏幕,玻璃时钟悬浮在湖面风景上

couch-tv金色黄昏场景主屏幕,显示继续观看列表与无广告应用栏

你的电视支持吗?快速检查方法

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 步):

  1. 开启开发者模式:电视上 Settings → System → About,连续按 Android TV OS build 7 次解锁 Developer options,打开 USB debugging / Network debugging(ADB)
  2. 准备电脑环境(Python 3.11+):python3 -m venv .venv 后安装 bridge/requirements.txt,并把 config.example.json 复制为 config.json 填入电视地址、家人和位置
  3. (仅 B)配对并启动 bridge:python bridge/pair_tv.py <电视名> 输入电视上显示的代码;cd remote && npm ci && npm run build 构建手机遥控器;再运行 python bridge/server.py
  4. 把主屏幕装上电视:从项目 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,点"添加到主屏幕"即可。

couch-tv手机遥控器界面:方向键、音量控制、继续观看与按名字找片

Remote 页是传统遥控器(方向、音量、Home、电源),Watch 页是继续观看 + 你的应用,底部输入框直接说想看的剧。安全提醒:bridge 只服务家庭网络,永远不要把 5400 端口转发到公网。详见 docs/REMOTE.md。

儿童模式 + TV 端设置,都在这台电视上完成

儿童模式默认关闭,开启后孩子的首页只剩一栏你挑好的剧(大海报直接点开),下面是你允许的应用,没有应用商店、没有设置入口、没有别人的观看记录,右上角"成人"入口要输 家长 PIN 才能出去。

couch-tv儿童模式主屏幕,大尺寸剧海报与受限应用列表

日常设置则不用电脑:应用栏最右的齿轮(或遥控器设置键)里,可以直接改语言、天气位置、外观与场景、应用和顺序、家庭成员和快捷按钮。

couch-tv电视端设置界面,可直接更改语言、外观、应用顺序与快捷按钮

🛡️ 隐私与安全:数据不出家门

  • 设置(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:

couch-tv在Apple TV上的自定义主屏幕界面

couch-tv在Roku上呈现的夜间场景频道界面

couch-tv在Fire TV Stick上的自定义主屏幕效果

延伸阅读

登录后查看全文
couch-tv