simbasjungles/free-my-tv

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/simbasjungles/free-my-tv.svg?style=card)](https://bestofgithub.dev/repo/simbasjungles/free-my-tv)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/simbasjungles/free-my-tv.svg)](https://bestofgithub.dev/repo/simbasjungles/free-my-tv)

Loading README…

Key	What it does	Default
`tmdb_key`	Your free TMDB key, for the picks	empty
`tmdb_region`	Your country (two letters): which titles are on which app	`US`
`watchmode_key`	Optional, free Watchmode key: a pick opens the title's page in its app	empty
`plex_url` and `plex_token`	Optional, your Plex server's `plex.direct` address and token: its newest titles join the picks and open on their page	empty
`trakt_client_id`	Optional: the Client ID of your own free Trakt API app. Home Settings > Picks then gets a Trakt row to sign in with a code, and the picks start with what you're in the middle of, bring in your watchlist and leave out what you've watched. Google TV only	empty
`latitude`, `longitude`	Your city, for the weather and the sunset	New York
`city`	The name on the weather card	`Weather`
`hide_animation`	Leave cartoons and anime out of the picks	`false`
`open_in_stremio`	A pick opens on its page in Stremio when the Stremio app is on the TV, instead of in the app it streams on. The picks stay the same: only from the TV's own apps. Google TV only	`false`
`language`	`auto` (follows the TV), or a language with a translation (`en`, `pt`, `es`, `de`, `ru`, `fr`, `ja`…)	`auto`
`show_crypto`	Show Binance crypto prices on home and screensaver	`true`
`currency`	Crypto prices in `USD`, `EUR`, `BRL`…	`USD`
`temperature`	`C`, `F` or `auto`	`auto`
`theme`	`auto` (dark from sunset to sunrise), `light` or `dark`	`auto`
`disable_assistant`	Also turn off Google Assistant	`false`
`screensaver`	`false` keeps the TV's own screensaver: Free My TV then changes only the home screen and the promo apps (Google TV)	`true`
`hide_services`	Streaming services to leave out of the picks even when their app is on the TV (`netflix`, `prime`, `disney`…), comma separated; for apps the TV ships that you don't subscribe to. It is where the switches in Home Settings › Picks › Picks from start; what you switch on the TV wins. Google TV only	empty
`hide_apps`	Apps to leave out of the shelf, All Apps and the picks, by id or name (part of it), comma separated; for apps the TV ships that can't be uninstalled, like Samsung's built-in Netflix. LG and Samsung only	empty
`shelf_apps`	The shelf's apps in this order, by id or name (part of it), comma separated; changing it wins once over the shelf picked on the TV. On Samsung, a whole app id also brings an app the TV leaves out of its list, like one installed in Developer Mode. LG and Samsung only	empty
`drawer_first`	`true` opens the home screen with the drawer already out (apps in the middle, inputs, weather and prices below), so nothing has to be scrolled to reach the inputs; Back closes it to the full page. For a TV whose streaming apps live on a box, where the picks stay empty. LG and Samsung only	`false`
`immich_server`	Optional: your Immich server: your own photos come from it, on each TV you send its key to (with `tools/send_key.py`, never here). Google TV only	empty

What	Where
Apps to turn off	`DEBLOAT` in `HomeMode.java`
Apps never to touch	`PROTECTED` in the same file
Apps on the shelf	`SHELF` in `HomeApps.java`
Your brand's live TV app	`LIVE_TV_APPS` in the same file

File	What it is
`HomeView.java`	The home screen
`HomeMode.java`	Switching between Free My TV and Original
`Adb.java`	The TV's own ADB, from inside the TV
`Recs.java`	The picks (TMDB)
`KeyPage.java`, `Qr.java`	The TMDB key sent from a phone, and its QR code
`WatchNext.java`	Continue Watching from the TV's lists
`WatchArt.java`	Continue Watching pictures, only from the TV
`HomeData.java`	Weather and prices
`HomeApps.java`	The shelf, inputs and All Apps
`DreamView.java`	The screensaver
`SettingsActivity.java`	The settings screen (the app's icon)
`Prefs.java`	Settings changed on the TV
`RemoteKeys.java`	The remote's app buttons (TCL, Sony, Xiaomi and others)
`RecentApps.java`, `ScreenBlur.java`	Recent Apps, over a blurred copy of the screen
`Watchdog.java`	The safety net
`web/home.js`	The home screen on LG TVs
`web/tv.js`	The TV's apps and inputs, on LG and Samsung
`webos/build.py`, `webos/install.py`	The LG app package and its install
`tizen/build.py`	The Samsung app package

simbasjungles/free-my-tv

Free My TV

What you get

Install

The easy way: an AI assistant

The ready APK

The manual way

LG TVs (webOS)

Samsung TVs (Tizen)

Settings

The TMDB key

Opening a title, not just its app (optional)

Your own photos (optional)

From an Immich server

Your Plex library (optional)

Going back

What it changes

Any TV

Make it yours

How it works

Translations

Privacy

Credits

License