Repolode
simbasjungles

simbasjungles/free-my-tv

开源、无广告的 Google TV / Android TV 主屏幕替代方案,展示你已安装应用中的热门推荐、天气和加密货币价格。

Star
1,020
Fork
112
未关闭 Issue
6
最近提交
9小时前

这是什么?

Free My TV 用于替换 Google TV 和 Android TV 设备的原生主屏幕与屏保。主屏幕没有广告位、横幅或自动播放的推广内容,顶部展示你选择的流媒体应用,顺序也可以在电视上自行调整。热门推荐只来自你已安装应用中可观看的影片和剧集,并提供电影和剧集分类标签页。侧边面板包含逐小时天气预报、日出日落时间,以及可选的 Binance 加密货币价格。

项目是一个不依赖 Gradle 和第三方库的原生 Java Android 应用,通过脚本调用 aapt2、javac、d8、zipalign 和 apksigner 构建 APK。安装时直接使用电视自身的 ADB 环回连接,执行设置主屏幕、禁用系统包等标准命令,不会卸载应用。看门狗进程会在连续崩溃后自动恢复原厂主屏幕。

配置可通过 config.properties 文件、电视端设置界面完成,也可以借助 Claude Code 进行定制。推荐功能需要免费的 TMDB API 密钥,天气数据来自 Open-Meteo。

核心功能

  • 01替换主屏幕和屏保,没有广告或推广内容。
  • 02顶部应用栏由用户选择并可在电视上排序。
  • 03每小时更新来自已安装应用的热门推荐,并提供电影和剧集标签页。
  • 04侧边面板显示天气、日出日落时间,以及可选的加密货币价格。
  • 05界面昼夜主题随当地日落时间自动切换。
  • 06一键切换回原厂主屏幕,不卸载任何应用。

适用场景

  • 去除 Google TV 或 Android TV 主屏幕上的推广栏和自动播放广告。
  • 把常用的流媒体应用集中放在一个醒目的应用栏中。
  • 在未直接支持的电视品牌上,借助 AI 助手调整应用列表后使用。
  • 学习一个无第三方依赖、用 Java 编写的小型 Android 启动器。

快速上手

  1. 1

    克隆代码仓库

    git clone https://github.com/simbasjungles/free-my-tv && cd free-my-tv
  2. 2

    在 Mac 上安装 Android 构建工具

    brew install --cask temurin android-commandlinetools android-platform-tools
  3. 3

    安装 Android SDK 平台和构建工具

    sdkmanager "build-tools;34.0.0" "platforms;android-34"
  4. 4

    构建 APK(在 config.properties 中设置城市和 TMDB 密钥后再次运行)

    ./build.sh

使用前须知

  • 需要在电视上开启开发者模式和 USB 调试。
  • 热门推荐需要一个免费的 TMDB API 密钥。
  • 手动安装需要在电脑上准备 JDK、Android SDK 和 adb;Windows 用户需要使用 WSL。

标签

常见问题

free-my-tv 是什么?
开源、无广告的 Google TV / Android TV 主屏幕替代方案,展示你已安装应用中的热门推荐、天气和加密货币价格。 Free My TV 用于替换 Google TV 和 Android TV 设备的原生主屏幕与屏保。主屏幕没有广告位、横幅或自动播放的推广内容,顶部展示你选择的流媒体应用,顺序也可以在电视上自行调整。热门推荐只来自你已安装应用中可观看的影片和剧集,并提供电影和剧集分类标签页。侧边面板包含逐小时天气预报、日出日落时间,以及可选的 Binance 加密货币价格。
free-my-tv 可以免费使用吗?用的什么许可证?
free-my-tv 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
free-my-tv 还在维护吗?
活跃维护中。free-my-tv 最近一次提交是在 2026年10月20日。
free-my-tv 适合用来做什么?
去除 Google TV 或 Android TV 主屏幕上的推广栏和自动播放广告。 把常用的流媒体应用集中放在一个醒目的应用栏中。 在未直接支持的电视品牌上,借助 AI 助手调整应用列表后使用。 学习一个无第三方依赖、用 Java 编写的小型 Android 启动器。
free-my-tv 怎么安装和运行?
克隆代码仓库: git clone https://github.com/simbasjungles/free-my-tv && cd free-my-tv 在 Mac 上安装 Android 构建工具: brew install --cask temurin android-commandlinetools android-platform-tools 安装 Android SDK 平台和构建工具: sdkmanager "build-tools;34.0.0" "platforms;android-34" 构建 APK(在 config.properties 中设置城市和 TMDB 密钥后再次运行): ./build.sh
在哪里获取 free-my-tv?
源代码和安装说明在 GitHub 上:https://github.com/simbasjungles/free-my-tv

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目