如何制作couch-tv自定义场景:用你的照片+AI生成背景,打造独一无二的电视主屏
如何制作couch-tv自定义场景:用你的照片+AI生成背景,打造独一无二的电视主屏
couch-tv 是一款开源的 Google TV 主屏与手机遥控器项目,它的自定义场景(Custom Scene)功能可以让任意一张照片、或者 AI 文生模型生成的背景,变成带磨砂玻璃大时钟的电视主屏背景。本文将手把手带你从零做出第一个专属背景,并把它推到电视上。
🎬 先认识一下:couch-tv 的"场景"是什么?
couch-tv 的电视主屏默认有 5 个内置场景(夜晚、金色时刻、水面、雾山、黎明),每 20 秒自动轮换,每个场景都是"一张照片 + 一块悬浮在山林之后的磨砂玻璃大时钟"。所谓自定义场景,就是用你自己的照片(或 AI 生成的背景)做底图,再自由设计时钟的位置、大小、字体和日期样式。
一个自定义场景由这几个文件组成,统一放在 tv-home/web/backgrounds/mine/ 目录下(该目录被 git 忽略,你的照片只留在自己的电脑和电视上,分享项目也不会带出去):
| 文件 | 作用 |
|---|---|
scene-<id>.jpg |
你的照片,1920x1080 |
scene-<id>-glass.jpg |
模糊提亮副本,用于填充时钟的"磨砂玻璃"质感 |
scene-<id>-fg.webp |
可选的前景抠图,让天际线"压在"时钟数字前面 |
完整官方教程见 docs/MAKE-A-SCENE.md,电视主屏的全部功能介绍见 docs/TV-HOME.md。
📸 第一步:准备照片——自己拍,或让 AI 生成
做自定义场景有两条路,任选其一:
路线 A:用你自己的照片(海边度假照、家人合影、窗外风景都可以)。选片小技巧:
- 画面比例最好是 16:9,至少 1920 像素宽,电视上才够清晰;竖图也行,工具会自动裁出 16:9 条带
- 时钟落点处要"安静":通常是画面上半部分的天空、水面或一面墙。人脸和复杂细节刚好压在数字后面,时间就会难读
- 人物照片建议让人脸处于画面下方
路线 B:描述一个地方,让 AI 文生模型替你画。官方文档收录了制作内置场景时使用的提示词模板,可以直接套用:
Wide cinematic photograph, 16:9. [用你的话描述这个地方:有什么、什么季节、什么时间、什么光线。] 景物位于画面下半部;上半部是开阔、平静的天空,顶部中央没有飞鸟和穿行的云。全画幅相机、24mm 镜头、自然色彩、高端风光摄影。无人物、无文字、无 logo。
要求 16:9、约 2K 分辨率。生成后先自己看一眼,不满意就重roll。下面这张"云雾山谷黎明"就是典型的 AI 场景底图效果:
🔒 隐私提示:工具只拷贝像素,不会带上 EXIF、相机型号或 GPS 信息,照片文件只留在你自己的设备上。
⚙️ 第二步:用 make-scene.py 一键生成场景文件
先给项目虚拟环境装上依赖:
.venv/bin/pip install numpy Pillow
.venv/bin/pip install pillow-heif # 可选:需要 iPhone HEIC 照片时
然后一条命令生成场景(工具源码在 tv-home/tools/make-scene.py):
.venv/bin/python tv-home/tools/make-scene.py photo.jpg beach
其中 beach 是场景 id:只能用小写字母和数字、不超过 24 个字符,且不能和内置场景重名。运行后它会在 tv-home/web/backgrounds/mine/ 写入 scene-beach.jpg 和 scene-beach-glass.jpg,并把一段可以直接粘贴进 config.json 的配置打印出来。
🕐 第三步:设计你的玻璃时钟,写进 config.json
把场景加进 config.json 的 home.my_scenes 里(可参考 config.example.json 中 home 段落的写法):
"home": {
"my_scenes": [
{
"id": "beach",
"name": "Summer at the beach",
"clock": { "x": "centre", "y": 0.14, "size": 0.37, "font": "antonio" },
"date": "above",
"text": "light"
}
]
}
常用参数速查表:
| 键 | 作用 | 默认值 |
|---|---|---|
id(必填) |
第二步生成的场景 id | — |
name |
电视"外观设置"里显示的名字 | Your scene 1 |
clock.x |
时钟水平位置:left / centre / right |
centre |
clock.y |
时钟顶部距屏幕顶部的高度(0.12~0.6) | 0.14 |
clock.size |
数字高度占屏幕比例(0.2~0.45) | 0.37 |
clock.font |
antonio(内置高窄风格)或 inter(更圆润,接近 iPhone 锁屏) |
antonio |
date |
日期天气行放在时钟 above 还是 below |
above |
text |
light:白色日期+亮玻璃;dark:深色日期+烟熏玻璃,适合浅色照片 |
light |
cutout |
启用了前景抠图时设为 true |
false |
video |
启用循环动态背景 scene-<id>.mp4 时设为 true |
false |
几个调出好效果的小窍门:
- 时钟放在画面最安静的区域,用
x、y把它挪开人脸 - 照片偏亮偏白时,白色玻璃会发虚,试试
"text": "dark" inter600 字重最接近 iPhone 锁屏观感;antonio则是 couch-tv 的招牌味道
🖥️ 第四步:上电视前,先在电脑里预览
不用反复装电视,本地起个静态服务就能实时调参:
python3 -m http.server 8000
然后打开(myscenes 参数就是上面那段 JSON 压缩成一行):
http://127.0.0.1:8000/tv-home/web/index.html?mock=1&scene=beach&myscenes=[{"id":"beach","clock":{"x":"left","y":0.16}}]
直接改地址栏里的数字就能看到时钟挪位置,调到满意后再把数字抄回 config.json,比在电视上盲调高效得多。下面是内置"水面"场景的效果,玻璃时钟浮在湖面、倒影没入水中:
📺 第五步:把自定义场景推到电视上
你的场景默认排在内置场景之后参与轮换。想指定顺序(或排除某些内置场景),在 home.scenes 里列出 id 即可:
"scenes": ["beach", "night", "fog"]
不同部署方式的生效方式:
- 方案 B(电脑 bridge 桥接):bridge 直接读取仓库里的
tv-home/web,新场景文件已经在了——重启 bridge,然后在电视上按 Home 键即可 - 方案 A(无电脑,场景内置于 App):照片要打包进 App,所以需要自己构建一次:
sh <a href="https://link.gitcode.com/i/6da7d6c845287ecb4f2167877ad73b3f" target="_blank">scripts/build-apk.sh</a>(需 JDK 21 和 Android SDK),再用 tv-home/tools/apply.sh 安装:APK=dist/couch-tv-home.apk TV_IP=<电视地址> sh tv-home/tools/apply.sh - 三星电视:
samsung/build.py打包时会自动带上tv-home/web,下次构建安装即可
只改已内置场景的时钟位置或名字则不需要重新构建:编辑 config.json 后再跑一次 apply.sh 就行。所有场景参数细节可查阅 docs/CONFIG.md 的 my_scenes 条目。
✨ 进阶玩法:天际线压住时钟 & 动态场景
1. 让山峦、树线"遮挡"时钟下沿(cutout 抠图)
如果你的照片是"开阔天空 + 清晰天际线"(山脊、树线、屋顶),可以抠出前景画在时钟之上,做出内置场景那种层次感。两种做法:
--sky-edit:用图像编辑模型把天空涂成纯品红色(#FF00FF),边缘最干净,内置场景就是这么做的(官方提示词在 docs/MAKE-A-SCENE.md 第 6 节)--depth:纯本地算法,无需 AI、照片不出本机,适合渐变天空(需安装scipy和pymatting)
生成时加 --preview 会在 build/scenes/ 输出一张品红底的对照图,肉眼确认抠图边缘干净后,再在 config.json 里加上 "cutout": true。
2. 会动的场景(video)
场景可以播放一段循环静音短片:星云流动、云卷云舒。用"视频第一帧"走一遍上面 1~3 步,把成片压成 H.264、1920x1080、无音轨存为 scene-<id>.mp4,再在场景配置里加 "video": true。只有当前场景在屏上时才播放,打开 App 的瞬间即停。
📝 小结
| 步骤 | 一句话 |
|---|---|
| 选图 | 16:9、1920 宽以上,上半部留出安静区域放时钟 |
| 生成 | make-scene.py 照片.jpg 场景id,一条命令产出全部文件 |
| 配置 | home.my_scenes 里设计时钟位置、大小、字体、日期样式 |
| 预览 | 本地 http.server + ?mock=1 在地址栏里实时调参 |
| 上电视 | 方案 B 重启 bridge;方案 A 重新构建 APK |
从一张照片到独一无二的电视主屏,总共只需要 5 步。快去 docs/MAKE-A-SCENE.md 对照完整指南,做出属于你的那块玻璃时钟吧。




