repowisesimbasjungles/free-my-tv

simbasjungles / free-my-tv

A fast, ad-free home screen for Google TV. Open source, built with Claude Code. One button to undo.

Java★ 3,204
Use in your agentAsk this codebase

github.com/simbasjungles/free-my-tvIndexed at 62e883bUp to date with upstream

What is free-my-tv?

free-my-tv is an ad-free home screen for Google TV, LG TVs and Samsung TVs. It replaces the stock home screen with selected apps, trending picks, weather, markets and a screensaver, while allowing the factory home screen to be restored. The project is primarily written in Java, with HTML, CSS, JavaScript, Python and shell components.

Written by a model from the README and the source

55 files and 841 symbols in 7 modules, led by Java (34 files) and Python (7).

Start reading

Code health

4.3out of 10Needs work

This codebase scores 4.3 out of 10 for code health, which we rate needs work. It also scores maintainability 5.3 and static performance 9.3 out of 10. The three are scored separately and never blended into one number. Risk is concentrated, as it usually is: 11 of 55 files are git hotspots, and they average 2.5 — which is where the fixes pay off most.

Full health report

Use simbasjungles/free-my-tv in your agent

Point Claude Code, Cursor, Codex or VS Code at this repository. Your agent gets the index this page is built from: cited answers, callers, history and health for any file.

  1. 1.In Claude, open Customize → Connectors, click +, then Add custom connector. On a Team or Enterprise plan an owner adds it first under Organization settings → Connectors.
  2. 2.Paste the server URL below as the Remote MCP server URL, then click Add.
  3. 3.Click Connect. A Repowise sign-in window opens. Approve access.
  4. 4.Repowise's tools are now available in your Claude chats.

Connect with one click. Sign in with Repowise (OAuth), no API key to copy. Works in Claude on the web, desktop, and mobile.

Docs
bash
https://api.repowise.dev/mcp/simbasjungles/free-my-tv
Editors need an API key: sign in to create one.Sign in to connect

This repo is public, so anyone with a Repowise account and an API key can connect.

Try asking

  • get_overview()
  • get_answer("how is free-my-tv put together?")
  • get_why("why is free-my-tv structured this way?")

Explore free-my-tv

Key features of free-my-tv

  • Free My TV removes sponsored rows, banners and autoplaying promotions from the home screen.
  • Free My TV lets users choose the apps shown on the shelf and set their order on the TV.
  • Free My TV shows trending titles and new releases from apps already installed on the TV, with separate Movies and Shows tabs.
  • Free My TV provides weather, sunrise and sunset information, plus optional cryptocurrency prices.
  • Free My TV changes between light and dark themes according to the city's sunset and provides a matching photo screensaver.
  • Free My TV can restore the factory home screen without uninstalling anything.

How simbasjungles/free-my-tv works

On Google TV and Android TV, app/src/io/freemytv/HomeActivity.java provides the home-screen entry point and connects the interface to the app's Android components. app/src/io/freemytv/HomeView.java draws the home screen, while app/src/io/freemytv/HomeMode.java switches between Free My TV and the original home screen. app/src/io/freemytv/HomeData.java supplies weather and price data, and app/src/io/freemytv/HomeApps.java manages the app shelf, inputs and All Apps. app/src/io/freemytv/Adb.java uses the TV's local ADB connection to apply home-screen, screensaver and package settings. The web/ directory provides the LG and Samsung interface, with web/home.js for the home screen and web/tv.js for apps and inputs.

The codebase has 55 files and 841 symbols in 7 modules, led by Java, Python and JavaScript. Code health is 4.3 out of 10, rated needs work.

Getting started with free-my-tv

  1. Enable developer mode and USB debugging on the TV, then note the TV's IP address.
  2. Install the required tools and Android platform packages on a Mac.
    brew install --cask temurin android-commandlinetools android-platform-tools

Commands copied from the README

simbasjungles/free-my-tv FAQ

What is free-my-tv?

free-my-tv is an ad-free home screen for Google TV, LG TVs and Samsung TVs. It provides selected apps, trending picks, weather, markets and a screensaver.

How does free-my-tv work?

free-my-tv uses a Java Android app on Google TV and Android TV, and HTML, CSS and JavaScript on LG and Samsung TVs. The Android app uses local ADB commands to set the home screen and related settings.

How do I install free-my-tv?

free-my-tv can be installed by enabling USB debugging, cloning the project, building it with ./build.sh and installing FreeMyTV.apk with adb. The build uses config.properties for the city and TMDB key.

What language is free-my-tv written in?

free-my-tv is primarily written in Java. The project also includes Python, JavaScript and shell files.

How is the free-my-tv code organized?

free-my-tv places its Android code in app, its TV web interface in web, LG packaging and installation tools in webos, Samsung packaging in tizen, and website files in docs.

Who is free-my-tv for?

free-my-tv is for people who want an ad-free home screen on Google TV, LG TVs or Samsung TVs, with their own apps and selected information on the TV.

What license does free-my-tv use?

free-my-tv uses the MIT license.

The summary, features and answers on this page are written by a model from the README and the source, and refreshed with each index.

About this page

Get a page like this for your own codebase

Repowise built this map of simbasjungles/free-my-tv from its source and git history. It parses every symbol, draws the dependency graph, scores each file's health from complexity, duplication, coverage and churn, finds hotspots and owners in the history, and writes documentation for every module. Your coding agent reads the same index over MCP, so its answers cite real files.

Index your repo freeSee how Repowise worksFree for 2 public repos, with a page like this one.

Prefer local? pip install repowise && repowise init indexes your own checkout, no account needed.