Reading the repo
Opening the box…
Reading the repo
Opening the box…
How to install on macOS
A fast, ad-free home screen for Google TV, LG webOS and Samsung Tizen. One button to undo.
Saved setup from 5 h ago
Will it work on macOS?
About ten minutes. You need a Google TV or Android TV (Android 8 or newer) and a computer on the same Wi-Fi. The APK goes on the TV, not on your phone (on a phone, the settings say so and nothing switches).
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).
On your computer, open an AI coding assistant (Claude Code, Codex or Antigravity) and say:
Install Free My TV (github.com/simbasjungles/free-my-tv) on my TV at 192.168.1.50. I live in Lisbon.
It downloads the code, installs the tools it needs, builds the app and puts it on your TV, and asks before anything important. Swap in your TV's IP and your city.
On the TV, open Free My TV → Home Screen → Free My TV. That's when the TV asks Allow USB debugging? for Free My TV: tick Always allow and accept.
No tools to install besides adb. The APK on the latest release has no TMDB key: add yours on the TV for the picks (Home Settings → TMDB key, below). It takes your city from the TV's time zone (change it in Home Settings → City).
If you built Free My TV yourself before, switch back to Original and uninstall it first: your build and the release are signed with different keys.
On the TV, do step 1 above.
On your computer, download FreeMyTV.apk from the release and install it:
adb connect 192.168.1.50:5555
adb install -r FreeMyTV.apk
On Android 14, Google Play Protect may hold the install with Risky app blocked: choose More details → Install anyway.
Install it with adb like this, not by opening the APK on the TV: from a file manager or a browser, Play Protect can refuse it outright with App blocked to protect your device (in some countries it blocks sideloaded apps that have an accessibility service or a notification listener, which Free My TV uses for the remote's buttons and Now Playing; #378).
On TCL TVs, also let it run in the background (TCL blocks it by default, and the switch never starts). An uninstall takes the permission back, so run it again after every new install:
adb shell "appops set io.freemytv AUTO_START allow || appops set io.freemytv APP_AUTO_START allow"
On the TV, do step 3 above.
For the picks, add your TMDB key in Home Settings → TMDB key (below).
Updates come to the TV. Once a week the APK from the release looks for a newer release and downloads it; the home screen then says so once, and Home Settings → Updates (the last row) installs it through Android's installer, which asks first (and, the first time, asks to allow Free My TV to install apps). OK on Updates also checks right away. The download must come from this repository's releases, match the size and SHA-256 GitHub lists, be newer, and be signed with the project's key. A build you made yourself checks only when you press Updates, and only says when a new version is out: build it again to update.
On the TV, do step 1 above.
Tools: a JDK (17+), the Android SDK command-line tools (build-tools 34, platform android-34) and adb. On a Mac:
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 Git Bash (which Claude Code uses there) or WSL.
Build:
./build.sh
The first run creates config.properties. Set your city and your TMDB key there, then run it again.
Install:
adb connect 192.168.1.50:5555
adb install -r FreeMyTV.apk
If the install seems stuck, look at the TV: on Android 14, Google Play Protect may hold it with Risky app blocked ("built for an older version of Android"), since Free My TV targets Android 13. Choose More details → Install anyway. Updates don't ask again.
Chromecast with Google TV on Android 14 keeps port 5555 closed even with USB debugging on: turn on Wireless debugging (Developer options), pair with adb pair <address:port> <code>, then run adb tcpip 5555 over that connection. Port 5555 closes again at every restart, so after one, Original, the watchdog and the boot check can't reach ADB until you run adb tcpip 5555 again (the pairing stays).
On TCL TVs, also let it run in the background (TCL blocks it by default, and the switch never starts). An uninstall takes the permission back, so run it again after every new install:
adb shell "appops set io.freemytv AUTO_START allow || a
…
Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.
Needs Git: xcode-select --install
git clone https://github.com/simbasjungles/free-my-tv.git cd free-my-tv
adb (Android platform-tools)
brew install --cask android-platform-tools
In the maintainers' order. Do the README instructions above first — they cover steps outside the terminal.
adb connect 192.168.1.50:5555 adb install -r FreeMyTV.apk adb shell "appops set io.freemytv AUTO_START allow || appops set io.freemytv APP_AUTO_START allow" brew install --cask temurin android-commandlinetools android-platform-tools sdkmanager "build-tools;34.0.0" "platforms;android-34" ./build.sh adb connect 192.168.1.50:5555 adb install -r FreeMyTV.apk adb shell "appops set io.freemytv AUTO_START allow || appops set io.freemytv APP_AUTO_START allow"
adb connect says Connection refused: ADB debugging is off on the device (turn it on in Developer Options, or restart the device), or the device has no ADB at all — Samsung, LG, Roku and Vizio TVs don't.adb devices shows unauthorized: accept the “Allow USB debugging?” prompt on the device.No reports for macOS yet.
GitManual AI Agent reads the 3 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.