> ## Content Index
> Fetch the complete content index at: https://claudefox.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# Free My TV: an open-source, ad-free home screen for Google TV, LG and Samsung, built with Claude Code
- URL: https://claudefox.com/free-my-tv-ad-free-google-tv-home-screen-built-with-claude-code/
- Published: 2026-11-15T09:14:57.000Z
- Updated: 2026-11-17T13:22:03.000Z
- Description: Free My TV (simbasjungles/free-my-tv) replaces the stock Google TV and Android TV home screen with an ad-free one and runs as an app on LG and Samsung TVs. It is MIT-licensed, has about 6,400 GitHub stars, one button to go back, and most commits carry a Claude Co-Authored-By line.
- Author: hupicake
- Tags: Built with Claude

*Updated November 16, 2026: Corrected the Fable 5.2 commit dates and the APK release history, added the full Co-Authored-By breakdown, and re-pulled stars and download counts.*

Free My TV is an open-source home screen for TVs, on GitHub at simbasjungles/free-my-tv. On Google TV and Android TV it replaces the stock home screen, which has sponsored rows, with a simpler one: a shelf of your apps, a few trending picks from services you already have, the weather and a clock. On LG (webOS) and Samsung (Tizen) TVs it runs as an app with the same layout. The README says it was built with Claude Code, and the commit history backs that up. Free My TV is not a streaming service and supplies no video. Its picks only point to apps already installed on the TV.

## Quick facts

- Platforms: Google TV and Android TV (Android 8 or newer), LG TVs on webOS 3 and newer, Samsung TVs on Tizen from 2015 on. Other TVs can use it through a Google TV streamer on HDMI.
- Licence and cost: MIT, free. Picks need a free TMDB API key.
- Code: a plain Android app in Java, built without Gradle by build.sh. LG and Samsung get a web app.
- Latest release: v1.5.0, November 13, 2026\. The first release, v1.0.0, came out October 20.
- Traction, checked November 15, 2026: about 6,400 stars and 1,130 forks. GitHub counts about 27,000 downloads of the APK (attached from v1.2.0 on), 13,500 of the Samsung .wgt and 2,700 of the LG .ipk across the releases.
- Languages: English and Brazilian Portuguese on the website. The TV interface has more languages, including Thai and Arabic; Arabic is on LG and Samsung only for now, and on Google TV an Arabic TV stays in English until the Android layout is mirrored.

## How to install

On Google TV or Android TV, first turn on developer mode and USB debugging on the TV, and note its IP address. The README then offers three ways in.

- With an AI assistant: open Claude Code, Codex or Antigravity on a computer on the same Wi-Fi and ask it to install Free My TV from the repo on your TV's IP, naming your city. It builds the app and installs it, and the project's CLAUDE.md tells it to ask before anything that changes the TV.
- The ready APK: download FreeMyTV.apk from the latest release, then run adb connect <TV IP>:5555 and adb install -r FreeMyTV.apk. The README says to install it this way and not by opening the APK on the TV, because Play Protect can block sideloaded apps that use an accessibility service or a notification listener. Only take the APK from the project's own GitHub releases page.
- Build it yourself: JDK 17 or newer, Android build-tools 34 and platform android-34, then ./build.sh. The first run creates config.properties for your city and TMDB key.

After installing, open Free My TV, choose Home Screen, then Free My TV. The TV then asks you to allow USB debugging for the app itself: tick Always allow. On LG, you install through Developer Mode or the webOS Homebrew Channel. On Samsung 2017 and newer, use TizenBrew Installer (Install from GitHub). For 2015 and 2016 Samsung TVs, you build and sign it yourself.

## First setup

Without a TMDB key you get the shelf, weather and clock, but no picks. The key is free from themoviedb.org. On Google TV you can send it from your phone: Home Settings, then TMDB key, shows a QR code. On LG and Samsung you type it with the remote. The release APK takes your city from the TV's time zone, and you can change it in Home Settings. Other services are optional and used only once you add them: a Watchmode key (so a pick opens on its own page in the streaming app), a Plex library or Trakt (both Google TV only), an Immich photo server, or Home Assistant buttons.

## What stands out

- A way back. Free My TV, then Home Screen, then Original brings back the factory home screen, the screensaver and every app it turned off. If the new home screen crashes three times in five minutes, it switches back by itself.
- It turns apps off instead of removing them. Stock home screens, screensavers and brand promo apps (on TCL, Philco, Multilaser and KTC-made TVs, among others) are disabled and not uninstalled. Picture, sound, inputs, remote pairing, Google services and the Play Store are on a protected list that is checked before every change.
- Its own measured speed. The README reports 96 MB of memory for the home screen against 242 MB for the stock one, measured by the project on a 98-inch TCL Google TV running Android 14\. Version 1.5 extends the cheaper drawing paths to every TV under 3 GB of RAM, Android 13 and 14 included; on a 2.6 GB TCL the home screen went from 193 to 110 MB, per the release notes.
- Remote buttons. On TCL, Sony, Hisense, Xiaomi, Philips, onn and Chromecast remotes, the app buttons that used to go through Google TV's home screen can be pointed at the apps you pick.
- A short list of network calls. The README says there are no accounts, no analytics and no tracking. The app talks to TMDB, Open-Meteo and Binance (for the price card, which you can turn off with show\_crypto), plus any optional service you configure. The release APK checks GitHub for updates once a week and only installs an update that matches the size and SHA-256 GitHub lists and is signed with the project's key.

## How it was built with Claude

Of the 803 commits on the main branch as of November 15, 579 carry a Claude Co-Authored-By line. Most name Claude Opus 5.5 (495, plus 21 for Opus 5.5 with 1M context). 37 name Fable 5.2, all made within about an hour early on November 13 UTC, just before v1.5.0 was published, and 13 name Sonnet 5.5\. The remaining 13 name Fable 5.1 (7), plain Claude (4), Opus 5 (1) and Opus 4.8 with 1M context (1). The maintainer wrote most of the commits (427 under one name, 8 under the GitHub handle). More than 120 other people have contributed fixes, many for a specific TV brand or remote.

The project's CLAUDE.md runs to about 11,000 words and is written as instructions for an assistant helping someone who may not be technical: say what you will do on the TV before doing it, and let the person do the taps. AGENTS.md points Codex and other assistants to the same file. Its hard rules come from things that went wrong. A restart with Google TV's setup app still running led to a factory reset on a Xiaomi. A Kalley 43G200 boot-looped, and a Huawei TV stopped at its logo until it was factory reset. The switch now refuses to run on those models. Other rules: never uninstall or clear system apps, only disable them so Original can bring them back. Never turn off an app that saved a Wi-Fi network, because Android would delete the network. Never commit config.properties or any key.

The same file has a section on adapting the app to a TV brand it doesn't know yet. It starts with read-only adb commands and has the person switch back to Original once to confirm everything returned. The README's suggestion for an unsupported brand is to open the folder in Claude Code and ask it to set the app up for that TV.

**Try it with your AI.** Want to see what your own Android or Google TV runs before installing anything? This prompt follows the read-only steps from the project's CLAUDE.md.

```
I have an Android TV / Google TV at [TV IP address] with USB debugging turned on, and
adb installed on this computer. I want to understand what its home screen setup looks
like before I try a replacement launcher such as Free My TV
(github.com/simbasjungles/free-my-tv).

First, check that adb is installed and run adb connect [TV IP address]:5555. Tell me if
the TV asks me to allow debugging, and wait for me to accept on the TV.

Then run only these read-only commands and explain the results in plain words:
- adb shell getprop ro.product.brand
- adb shell getprop ro.product.model
- adb shell getprop ro.build.version.release
- adb shell cmd package query-activities --brief -a android.intent.action.MAIN -c
  android.intent.category.HOME
- adb shell cmd role get-role-holders android.app.role.HOME
- adb shell settings get secure screensaver_components
- adb shell settings get secure screensaver_default_component
- adb shell pm list packages -s

From the package list, point out what looks like a promo, demo or store-mode app, and
what looks like a system piece (picture, sound, inputs, tuner, remote pairing, setup,
updates) that must never be turned off. Do not run pm disable, pm uninstall, settings
put or any other command that changes the TV. Mark anything you are unsure about as
unsure instead of guessing from the package name. If you think a change would help, show
me the exact command and wait for me to decide. When we are done, run adb disconnect.
```

## Known limits

- Google Assistant gets weaker. With Google TV's home app turned off, asking the Assistant to play a show can end in "Sorry, I don't understand", and searches may show only YouTube videos. Opening apps and apps' own voice search still work.
- Some devices are refused. On Amazon Fire TV the app runs, but Amazon's launcher keeps the Home button, so the switch to Free My TV mode is refused there. The Kalley 43G200 and Huawei TVs are refused after the incidents above. Phones are refused too.
- Sideloading friction. On Android 14, Play Protect may hold the install with "Risky app blocked" because the app targets Android 13\. Some 2016 Samsung TVs refuse developer installs, and Chromecast with Google TV on Android 14 closes port 5555 after every restart, so you have to run adb tcpip 5555 again.
- It relies on ADB. The switch, the Original mode and the watchdog work through the TV's own ADB, so USB debugging has to stay on. That leaves ADB listening on port 5555, so accept the TV's debugging prompt only for your own computer.
- Uninstalling while it is active leaves the stock apps disabled. The fix is to reinstall and choose Original, or run the adb pm enable steps in CLAUDE.md.

## Related on claudefox

- [couch-tv gives Google TV a clean home screen and a phone remote, with an optional Claude assistant](https://claudefox.com/couch-tv-google-tv-home-screen-phone-remote-claude/)
- [TV Detox gives an old Android TV a 30 MB ad-free home screen and a Claude Code cleanup you can undo](https://claudefox.com/tv-detox-android-tv-ad-free-home-screen-claude-code/)
- [CleanYourTV: debloat an Android TV or Google TV over Wi-Fi with Claude Code and get an Apple TV-style home screen](https://claudefox.com/cleanyourtv-debloat-android-google-tv-claude-code/)
- [IPVIO Stream: the Claude-built Android TV player, and the CLAUDE.md that keeps it shipping](https://claudefox.com/ipvio-stream-a-free-open-source-iptv-player-built-with-claude/)

## Problems and feedback

Bug reports and TV-specific reports go to the repository's GitHub issues (111 open issues and pull requests on November 15). Many fixes in the release notes credit the person who reported or patched a particular model. The project website is freemytv.io.

## FAQ

Does Free My TV need root? No. The README says it needs no root and uninstalls nothing, and one button brings back the factory home screen.

Does it work without a TMDB key? Yes, but without the picks. The shelf, weather, clock and screensaver still work.

Is there an APK? Yes. FreeMyTV.apk is attached to each GitHub release from v1.2.0 on; v1.0.0 and v1.1.0 shipped no APK. The README recommends installing it with adb install -r and not from a file manager on the TV.

Will it work on my Fire TV Stick? Only as an app. The project says Amazon's launcher keeps the Home button, so Free My TV cannot replace the home screen there.

Source: [GitHub: simbasjungles/free-my-tv](https://github.com/simbasjungles/free-my-tv?ref=claudefox.com), [Free My TV README](https://github.com/simbasjungles/free-my-tv/blob/main/README.md?ref=claudefox.com), [Free My TV CLAUDE.md](https://github.com/simbasjungles/free-my-tv/blob/main/CLAUDE.md?ref=claudefox.com), [Free My TV releases](https://github.com/simbasjungles/free-my-tv/releases?ref=claudefox.com), [freemytv.io](https://freemytv.io/?ref=claudefox.com)

This story first appeared in the [claudefox daily briefing for November 15, 2026](https://claudefox.com/daily-2026-11-15/).