Free My TV：无广告电视主屏

项目简介

Free My TV 是给 Google TV / Android TV、LG webOS 和 Samsung Tizen 电视用的开源主屏（launcher），用 Java 编写、借助 Claude Code 构建。它把电视自带主屏里的广告和推广行换成你自己装的应用、每小时更新的热门影视推荐、天气和行情信息，并且一键就能切回原厂主屏：不需要 root，也不会卸载任何东西。

主要功能

• 没有广告：没有赞助行、横幅或自动播放的推广。
• 应用玻璃架：把常用的流媒体应用摆在玻璃货架上，可直接在电视上挑选和排序。
• 热门推荐，不是赞助位：每小时更新三个推荐（可在 Home Settings 调到六个），取自本周热门和最新上线内容，且只来自你已安装的应用和你选定的服务；电影与剧集分 tab；Google TV 上还能接入自己的 Plex 库。
• Continue Watching（Google TV / Android TV）：Home Settings → Top of the screen 可把看到一半的内容放在最上方并显示进度，也可以换成大时钟或推荐。
• TMDB key 从手机传过去：Home Settings → TMDB key 显示二维码，扫码粘贴即可；LG 和 Samsung 上用遥控器输入。
• 天气与行情：逐小时或未来 5 天预报、日出日落，以及加密货币实时价格。
• Now Playing：后台播放的音乐、播客或电台会显示在主屏和屏保上（默认关闭，需在 Home Settings 打开）。
• 状态图标与鼠标（Google TV / Android TV）：顶部显示 Wi-Fi/以太网、蓝牙音频、USB 存储；支持鼠标和空中鼠标遥控器。
• 日夜自动换肤：跟随所在城市真实的日落时间切换明暗。
• 配套屏保：推荐内容的全屏图片配玻璃质感大时钟；LG 和 Samsung 上可换成缓慢漂移的大时钟加天气，避免 OLED 烧屏。
• 暗房调光（LG / Samsung）与自定义照片（Google TV / Android TV，最多 100 张，用作屏保和整点背景）。
• 性能：60 fps，主屏内存占用从 242 MB 降到 96 MB（在 98 英寸 TCL Google TV、Android 14 上测得）。
• 全部在电视上设置：语言、城市、温度单位、主题、推荐数量与来源服务、天气和行情卡片、货架应用等。

安装与使用

Google TV / Android TV（Android 8 及以上），需要一台连在同一 Wi-Fi 的电脑：

1. 电视上开启开发者模式：设置 → 系统 → 关于 → 连按 Android TV OS build 7 次，再到开发者选项里打开 USB 调试，记下电视 IP。
2. 电脑上从 latest release 下载 FreeMyTV.apk，用 adb 安装：

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

3. 电视上打开 Free My TV → Home Screen → Free My TV，在「允许 USB 调试」弹窗中勾选始终允许并接受。

也可以让 AI 编程助手（Claude Code、Codex、Antigravity）按 README 的步骤下载、构建并安装；或手动构建（需要 JDK 17+、Android SDK build-tools 34 与 platform android-34、adb）：

./build.sh

LG（webOS 3 及以上）：通过 LG 开发者模式安装，电脑上先 python3 webos/build.py 构建，再执行 python3 webos/install.py <电视 IP>；也可以用 webOS Homebrew Channel 添加仓库 https://freemytv.io/webos/apps.json。安装后按住遥控器上的数字键即可从任意位置打开。

Samsung（2017 及更新）：在 TizenBrew Installer 中选择 Install from GitHub → simbasjungles/free-my-tv；2015、2016 机型需自行构建。

推荐内容需要先在 Home Settings → TMDB key 填入自己的 TMDB key。

注意事项

• APK 装在电视上，不装在手机上；手机上打开只会有提示，不会切换主屏。
• 自行构建的版本与 release 签名不同，混装前需先切回 Original 并卸载旧版本。
• 部分 TCL 电视默认阻止后台运行，需执行 README 里的 appops 命令；卸载会收回该权限，每次重新安装后都要再执行一次。
• Android 14 上 Google Play Protect 可能拦截安装，选择 More details → Install anyway；建议用 adb 安装，而不是在电视上直接打开 APK。
• Chromecast with Google TV（Android 14）需先开启无线调试并 adb pair，重启后需重新执行 adb tcpip 5555。

---

本作品整理自 GitHub 开源项目 simbasjungles/free-my-tv，原作者 @simbasjungles，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。