AB
AiBoss
project

free-my-tv - 为 Google TV、LG 与三星电视打造的无广告开源主屏

free-my-tv 是 simbasjungles 维护的 MIT 许可开源项目,用无广告主屏替换 Google TV、LG 与三星电视的默认界面,把常用应用、趋势推荐、天气与行情集中到一屏,并提供一键恢复原厂主屏的退路。

free-my-tv 是一个面向电视的开源主屏替代方案,由维护者 simbasjungles 开发,采用 MIT 许可证。按项目自述,它要解决的问题很直接:智能电视的默认主屏往往塞满赞助位、横幅和自动播放的推广内容,而用户真正想打开的应用被挤到后面。free-my-tv 用一层自建主屏替换掉这些内容,把常用流媒体应用、每小时更新的趋势推荐、天气与行情信息放在同一屏上,并跟随当地日落时间在浅色与深色主题之间切换。它适合愿意在电视上开启开发者模式、通过电脑侧载 APK 的用户,尤其是使用 Google TV、Android TV、LG 或三星电视、并且在意主屏干净程度与响应速度的人。

维护者与状态

项目仓库为 simbasjungles/free-my-tv,维护者是 simbasjungles,许可证为 MIT。仓库创建于 2026-10-19,最后一次提交在 2026-11-13,最新正式版本为 v1.5.0,发布于 2026-11-13。截至 2026-11-16 读取数据时,仓库星标数为 6440。项目另有一个官网 freemytv.io,用于介绍与分发。

从时间线看,这是一个创建时间不长、但迭代节奏较快的项目:不到一个月内已经发布到 v1.5.0,并且有持续的提交记录。需要说明的是,以上均为仓库接口中的客观信息,本文没有对项目进行实际安装或运行验证。

主要能力

以下能力均来自项目 README 的自述,属于维护者的描述,并非第三方评测结论。

  • 无广告。 项目称主屏不含赞助行、横幅或自动播放的推广内容。
  • 应用优先。 用户常用的流媒体应用以「玻璃搁板」形式排布,可直接在电视上挑选应用并调整顺序;在 Google TV 与 Android TV 上,还可以让最近打开的应用排到最前。
  • 趋势推荐。 每小时给出三个新鲜推荐(在 Home Settings 中最多可设六个),来源限定为用户已安装的应用以及自选的服务;电影与剧集各有独立标签页,Google TV 上还可接入用户自己的 Plex 媒体库。
  • 继续观看。 在 Google TV 与 Android TV 上,可把各应用中看到一半的内容连同进度置顶,按 OK 直接在对应应用里续播;顶部也可以换成大时钟或推荐内容。
  • TMDB 密钥配置。 在 Home Settings 中显示二维码,用手机扫码后粘贴密钥;LG 与三星电视上则用遥控器输入。
  • 天气与行情。 一键查看逐小时预报(或未来五天)、日出日落时间与加密货币实时价格;在 LG 与三星电视上还提供未来两小时降雨、紫外线指数与空气质量。
  • HDMI 与直播电视入口。 可指定顶部第一个按钮打开直播电视还是某个 HDMI 输入,并可选择抽屉中显示哪些输入及其顺序。
  • 正在播放。 后台播放的音乐、播客或电台会在主屏与屏保上显示标题、艺人与应用名,该功能默认关闭。
  • 状态图标与鼠标操作。 在 Google TV 与 Android TV 上可显示 Wi-Fi 或有线网络、蓝牙音频与 U 盘状态;支持鼠标或空中鼠标遥控器的悬停、滚轮与点击。
  • 屏保与调光。 提供与主屏配套的全屏照片屏保和大号玻璃时钟;LG 与三星电视上可改为缓慢漂移的大时钟加天气,以减少 OLED 烧屏风险,并提供低、中、高三档或自动调光。
  • 自定义照片。 在 Google TV 与 Android TV 上可从电脑发送最多 100 张照片,用于屏保或作为主屏背景轮换。
  • 性能与安全。 项目称主屏以 60 fps 运行、每帧 16.6 ms,主屏内存占用为 96 MB 而非 242 MB(减少 60%),数据来自一台运行 Android 14 的 98 英寸 TCL Google TV;同时强调不需要 root、不卸载任何系统应用,一键即可恢复原厂主屏。

使用入口

项目源码与发布包位于 simbasjungles/free-my-tv,项目介绍页为 freemytv.io。

据 README,安装大约需要十分钟,前提是一台 Google TV 或 Android TV(Android 8 或更新)以及一台连接同一 Wi-Fi 的电脑;APK 装在电视上,而不是手机上。安装前需在电视上开启开发者模式:进入「设置 → 系统 → 关于」,连续按七次「Android TV OS build」,再在「设置 → 系统 → 开发者选项」中打开 USB 调试,并记下电视的 IP 地址。

README 给出三种安装路径。其一是借助 AI 编程助手:在电脑上打开 Claude Code、Codex 或 Antigravity 等工具,说明电视 IP 与所在城市,由助手下载代码、安装依赖、构建并部署。其二是使用现成 APK,只需 adb:

adb connect 192.168.1.50:5555
adb install -r FreeMyTV.apk

其三是手动构建,需要 JDK 17 及以上、Android SDK 命令行工具(build-tools 34、platform android-34)与 adb,首次运行 ./build.sh 会生成 config.properties,填入城市与 TMDB 密钥后再次运行即可。安装完成后,在电视上打开 Free My TV → Home Screen → Free My TV,电视会弹出「允许 USB 调试?」的授权提示,勾选「始终允许」并确认。

README 还提到,发布版 APK 每周会检查一次新版本并下载,主屏会提示一次,随后可在 Home Settings → Updates 中通过 Android 安装器完成安装;下载内容需来自该仓库的发布页、大小与 SHA-256 与 GitHub 所列一致、版本更新且使用项目密钥签名。

许可与限制

项目采用 MIT 许可证,可按许可证条款使用、修改与分发。

README 中列出的已知限制与注意事项包括:现成 APK 不含 TMDB 密钥,需在电视上自行添加,否则趋势推荐无法工作;城市默认取自电视时区,可在 Home Settings 中修改。若此前自行构建过,需先切回 Original 并卸载,因为自建版本与发布版签名密钥不同。在 Android 14 上,Google Play Protect 可能以「Risky app blocked」拦截安装,需选择「More details」→「Install anyway」;README 建议用 adb 安装而非在电视上直接打开 APK,因为在部分国家 Play Protect 会直接阻止带无障碍服务或通知监听器的侧载应用,而 Free My TV 正需要这两项权限来实现遥控器按键与「正在播放」功能。TCL 电视默认阻止后台运行,需额外通过 adb 授予自启动权限,且每次卸载重装后都要重新执行。Chromecast with Google TV 在 Android 14 上即使开启 USB 调试也保持 5555 端口关闭,需改用无线调试配对后再执行 adb tcpip 5555,且每次重启后端口会再次关闭。此外,部分功能存在平台差异:继续观看、状态图标、鼠标操作与自定义照片仅在 Google TV 与 Android TV 上提供,调光与屏保的大时钟模式则面向 LG 与三星电视。