seun-novodev/android-tv-debloat-toolkit v1.2

Android TV Toolkit v1.2

on GitHub

What's new in v1.2

The exe is gone -- and that's a good thing.

Previous versions shipped a pre-built run_toolkit.exe that was flagged as a trojan by Windows Defender and VirusTotal. This was a false positive caused by how the exe was packaged, not malicious code. v1.2 removes it entirely. You now run the toolkit directly from the Python source, which antivirus tools have no issue with.

How to run

1. Install Python 3.8+ from python.org (check "Add Python to PATH" during install)
2. Install the dependency: pip install PySimpleGUI
3. Run: python run_toolkit.py

Full setup instructions are in the README.

Changes

Antivirus false positive fix

• Removed run_toolkit.exe from the repo
• Replaced all os.popen() shell calls with subprocess.run() using argument lists (no shell involvement)
• Added IP address validation so no user input is ever passed unsanitised to a system command

New feature: Pair and Connect (Android 11+ / Chromecast with Google TV)

• Added a dedicated "Pair and Connect" button for devices that use Wireless Debugging with a pairing code
• Handles the full adb pair then adb connect flow automatically
• Fixes the connection failures reported by Chromecast with Google TV users

Reliability improvements

• ADB commands now use return codes for error detection rather than fragile string matching
• Errors are reported clearly in the UI rather than silently failing
• ADB port is now consistent across all functions (was hardcoded to 5555 in some places)
• The toolkit automatically finds the bundled adb/ folder without needing ADB on your system PATH

Code quality

• Replaced global variables with a TVConnection class
• run_toolkit.pyw brought up to parity with run_toolkit.py

Upgrading from v1.1 / v1.1.1

You do not need your old installation. Just download the source zip, install Python and PySimpleGUI, and run python run_toolkit.py. Your TV settings are not affected.

Known limitations

• The bundled adb.exe in the adb/ folder is 32-bit. If you get a 64-bit compatibility error, replace it with the latest version from Google's platform-tools.
• Windows only. The Python source should run on Mac and Linux with ADB installed, but this has not been formally tested.