simbasjungles/free-my-tv

选用指南

AI 根据 README 整理 · 2026/10/20 04:36:34

适用场景

适用于希望去除 Google TV 或 Android TV 上广告和预装应用干扰的用户，可自定义主屏幕显示内容。

查看 README 依据

## What you get - **No ads.** No sponsored rows, banners or autoplaying promos. Not one. - **Your apps, front and center.** The streaming apps you actually use, on a glass shelf. - **Trending, not sponsored.** Three fresh picks every hour from what's trending this week and the latest releases, only from apps you already have. Movies and Shows get their own tabs. - **Weather and markets, one press away.** The hour-by-hour forecast, sunrise and sunset, and live crypto prices. - **Light by day, dark by night.** It follows your city's real sunset, the way your phone does.

- Google TV's recovery home, Play Games and YouTube Music; - on TCL TVs, the TCL Channel, messages, store demo, hotel menu, manuals, mirroring and logging apps; - Google Assistant, only with `disable_assistant=true`. - Picture, sound, inputs, remote pairing, Google services and the Play Store are on a protected list, checked before every change. ## Any TV Free My TV runs on Google TV and Android TV: TCL, Sony, Hisense, Philips, Xiaomi and more, plus streamers like Chromecast with Google TV, the Google TV Streamer, onn 4K and NVIDIA Shield.

目标用户

面向拥有 Google TV 或 Android TV 设备（如 TCL、Sony、Hisense 等）的用户，也支持通过流媒体设备使用。

查看 README 依据

- Google TV's recovery home, Play Games and YouTube Music; - on TCL TVs, the TCL Channel, messages, store demo, hotel menu, manuals, mirroring and logging apps; - Google Assistant, only with `disable_assistant=true`. - Picture, sound, inputs, remote pairing, Google services and the Play Store are on a protected list, checked before every change. ## Any TV Free My TV runs on Google TV and Android TV: TCL, Sony, Hisense, Philips, Xiaomi and more, plus streamers like Chromecast with Google TV, the Google TV Streamer, onn 4K and NVIDIA Shield.

使用方式

通过命令行工具安装，需要启用电视的开发者模式和 USB 调试，并使用 adb 连接安装 APK。

查看 README 依据

1. **On the TV**, turn on developer mode: Settings → System → About → press *Android TV OS build* 7 times. Then Settings → System → Developer options → turn on **USB debugging**. Write down the TV's IP address (Settings → Network & Internet). 2. **On your computer**, get the code: ```bash git clone https://github.com/simbasjungles/free-my-tv && cd free-my-tv ``` 3. **Open [Claude Code](https://claude.com/claude-code) in that folder** and say: > Install Free My TV on my TV at 192.168.1.50. I live in Lisbon.

It installs the tools it needs, builds the app and puts it on your TV. Swap in your TV's IP and your city. 4. **On the TV**, open *Free My TV* → *Home Screen* → *Free My TV*, and accept the debugging prompt (tick *Always allow*). ### The manual way 1. **On the TV**, do step 1 above. 2. **Tools:** a JDK (17+), the Android SDK command-line tools (build-tools 34, platform android-34) and adb. On a Mac: ```bash brew install --cask temurin android-commandlinetools android-platform-tools sdkmanager "build-tools;34.0.0" "platforms;android-34" ```

On Linux, get OpenJDK 17, Android's command-line tools and adb from your package manager, then run the same `sdkmanager` line. On Windows, use WSL. 3. **Build:** ```bash ./build.sh ``` The first run creates `config.properties`. Set your city and your [TMDB key](#the-tmdb-key) there, then run it again. 4. **Install:** ```bash adb connect 192.168.1.50:5555 adb install -r FreeMyTV.apk ``` 5. **On the TV**, open *Free My TV* → *Home Screen* → *Free My TV*. ## Settings Everything lives in `config.properties`, created by the first build:

部署要求

需要 Google TV 或 Android TV（Android 12 或更新版本），以及同一 Wi-Fi 下的电脑。安装时需 JDK 17+、Android SDK 工具和 adb。

查看 README 依据

- **A screensaver to match.** Full-screen photos of the picks with a big glass clock. - **Fast.** 60 fps, every frame in 16.6 ms, on the TV's own chip. The home screen uses 96 MB of memory instead of 242 MB (−60%).<br>_{Measured on a 98″ TCL Google TV running Android 14.} - **Safe.** No root. Nothing is uninstalled. One button brings back the factory home screen. ## Install About ten minutes. You need a Google TV or Android TV (Android 12 or newer) and a computer on the same Wi-Fi. ### The easy way: Claude Code

It installs the tools it needs, builds the app and puts it on your TV. Swap in your TV's IP and your city. 4. **On the TV**, open *Free My TV* → *Home Screen* → *Free My TV*, and accept the debugging prompt (tick *Always allow*). ### The manual way 1. **On the TV**, do step 1 above. 2. **Tools:** a JDK (17+), the Android SDK command-line tools (build-tools 34, platform android-34) and adb. On a Mac: ```bash brew install --cask temurin android-commandlinetools android-platform-tools sdkmanager "build-tools;34.0.0" "platforms;android-34" ```

已知限制

作者未明确列出限制，但安装过程需要技术操作，且依赖 TMDB API 密钥获取推荐内容。

查看 README 依据

Changed something? Run `./build.sh` and install again. Keep `freemytv.keystore`: updates are signed with it. ### The TMDB key Free, and it takes two minutes: create an account at [themoviedb.org](https://www.themoviedb.org/signup), then open [Settings → API](https://www.themoviedb.org/settings/api) and request a developer key. Paste the *API Read Access Token* (or the *API Key*) after `tmdb_key=`. It's your key: `config.properties` stays out of git. ## Going back