Dock:让电视一直显示时间、日程和正在放的歌

一、这个项目解决的是什么问题

桌上通常有两块屏:笔记本用来干活,手机用来接收外界。中间缺一块——它不需要你操作,只是安静地待在那里,告诉你现在几点、今天还有什么安排、正在放什么歌。很多人的做法是把旧平板立在旁边,但平板会休眠、要充电、通知会打断你。

Dock 是把一台闲置的 Android TV 设备(一个旧盒子、一根 Fire TV Stick)接到一块副屏上,做成那块常亮的第三块屏。它的官方描述就是一句话:「你桌上缺的那块常亮屏。」项目是 Apache-2.0,作者 the-mrinal,当前版本 1.3.2。

二、核心设计机制

它的第一原则是「不打扰」。界面分四页,用遥控器左右切:Connect、Home、Calendar、Music。静止九十秒之后,界面会自动隐去秒数,再久一点进入纯黑屏保——只留一个时钟,而且这个时钟每分钟会漂移几个像素,防止 OLED 烧屏。任何按键就回来。

它的第二原则是「无云」。没有账号、没有遥测、不往任何服务器发数据。日历是你自己填的 ICS 地址(Google 日历可以导出私密地址,也可以用任何自建日历),音乐是通过本地的媒体通知监听拿到的,天气压根没做。这一点跟大部分「智能屏」产品是反着来的。

它的第三原则是「纯原生」。界面全部用 Android 原生的 View 画,没有 Compose、没有 React Native、没有 WebView。原因是这类设备常年不关机,任何一层抽象泄漏最后都会变成内存泄漏。代码结构里能看出这个取向:每个页面一个 binder,背景模糊是自己实现的(金字塔降采样加三次盒式模糊,API 31 以上再叠一层 GPU 效果)。

三、功能拆解

Home 页:秒级时钟、今天的日程、正在播放的内容。底部四个圆点表示你在第几页。

Calendar 页:一天的时间轴,个人日程和工作日程用不同颜色区分,可以上下滚动看别的日子。日历数据每 15 分钟从你填的 ICS 地址拉一次。

Music 页:如果配了 Spotify,这里是一个完整的遥控器——当前曲目、进度、播放控制、队列、最近播放。队列和最近播放需要 Spotify Premium,并且要自己在 Spotify 开发者后台建一个应用填 clientId。

Connect 页:手机投屏的接收端。AirPlay、Cast、Miracast 三个协议可以各自独立开关。开了之后会在局域网广播,投上来会自动切到全屏,角落留一个「Casting from xxx via AirPlay」的小胶囊。

通知:可以监听手机推来的媒体通知,在 Notices 页显示。需要手动授予通知监听权限。

VPN:内置 WireGuard 客户端,可以从电脑上传 .conf 配置文件,还支持系统的 kill-switch。

背景:当前播放的唱片封面做高斯模糊铺满全屏。这是它视觉上最讨巧的一处——你放什么歌,整块屏的色调就跟着变。

四、适合谁,不适合谁

适合的是:有一台闲置 Android TV 设备、一块副屏或旧显示器的人;想要一块不打扰的信息屏、但不想买智能音箱或智能相框的人;用 Spotify 听歌、希望桌上能看到在放什么的人;在意隐私、不接受「智能屏上传你的日程」的人。

不适合的是:期待触屏交互的人——它是遥控器操作的,没有触控;用 Apple Music 或网易云的人,音乐页只对接 Spotify;以及期待「装上就自动配好一切」的人,日历要自己填 ICS、Spotify 要自己建应用,这些都得动手。

五、几个需要提前知道的限制

第一,Spotify 的完整功能需要 Premium 和自建 clientId。免费账号只能看到基本播放状态。建应用时重定向地址要填 `com.ambient.tvclock://spotify-callback`,还要在开发者后台的 User Management 里把自己的账号加进去(应用处于开发模式时只有白名单账号能用)。

第二,日历不是自动的。要自己去 Google 日历的「整合日历」里拿 iCal 私密地址,粘贴到电视上的设置里。也可以用仓库里的脚本从电脑推过去。

第三,APK 不是每个版本都有。README 里明确写了「APK builds are produced manually per release — not every release has APKs attached」。没有的话要么自己用 Gradle 编,要么触发仓库的打包 workflow。

第四,包名是 com.ambient.tvclock,不是项目名。用 ADB 操作时别搞错。Fire TV 版和 Google TV 版是两个独立的应用 ID,可以装在同一台设备上共存。

六、项目现状

当前版本 1.3.2,2026 年 9 月 10 日发布。星数只有 6,但这不是质量指标——这个项目定位很窄(常亮副屏),受众本来就小。代码质量从结构上看是认真的:发布走 semantic-release 加约定式提交,有独立的打包 workflow,README 里把每个模块的文件名都列出来了。

七、常见问题

问:需要 root 吗?

答:不需要。普通应用加几个权限(通知监听、悬浮窗、可选的 VPN)。

问:必须用 Spotify 吗?

答:不是。不配 Spotify 的话 Music 页是空的,其他三页正常。

问:会不会烧屏?

答:它做了防护:静止一段时间后隐去秒数、进纯黑屏保、时钟每分钟漂移。但 OLED 上长时间显示任何内容都有风险,建议配合电视自己的像素刷新。

问:能显示天气吗?

答:目前没有。作者的设计取向是「不联网拿数据」,天气需要外部 API,所以没做。

问:Fire TV 和 Google TV 都能装吗?

答:都能。两个 flavor 的应用 ID 不同,可以共存。

问:怎么切页?

答:遥控器左右方向键在任何页面都能切四页;上下方向键在日历页是滚日期、在通知页是切通知。

下载地址

夸克网盘(永久有效):https://pan.quark.cn/s/ed6e0d6fee79

本教程由「宝藏星球屋」整理,更多软件、游戏、开源项目都在 https://cbge.top。

本站全部免费,如果觉得内容有用,可打赏支持服务器续费打赏支持
固定文章缩略图

新人必看的入站详细说明指南

解决的你的各种疑难杂症以及各种相关教程

前往查看 »
© 版权声明
THE END
喜欢就支持一下吧
点赞36 分享
评论 抢沙发
头像
欢迎您留下宝贵的见解!
提交
头像

昵称

取消
昵称表情代码图片

    暂无评论内容