Repolode
humblemuzzu

humblemuzzu/dumbtv

Shell scripts that debloat Fire TV and Android TV sets over ADB without root, removing ads, telemetry and unwanted apps, all reversible.

Stars
418
Forks
35
Open issues
1
Last commit
17 hours ago

What is it?

dumbtv is a set of scripts that runs from another computer over ADB to strip ads, telemetry and unwanted preinstalled apps from a TV. It needs no root and does not write to /system. It disables roughly 65 tracking and promotional packages, turns off ad tracking and voice features, and runs an on-device DNS filter that blocks Amazon telemetry and OTA endpoints.

The main target is Fire OS, with Android TV and Google TV covered by a different package list and launcher approach. Samsung, LG, Roku and similar systems have no shell access and are not supported. A configure step asks which apps to keep before anything is removed, and restore.sh reverts package state, app-ops, network rules and settings from a snapshot taken beforehand.

The repository also includes a small open-source home screen launcher with no internet permission, which replaces the stock Amazon home. A device catalog of per-model menu paths and quirks is maintained as YAML.

Key features

  • 01Disables about 65 ad, analytics and promotional packages over ADB without root.
  • 02Runs an on-device DNS filter that blocks Amazon telemetry and OTA servers.
  • 03Asks which apps to keep before removing anything.
  • 04Restores packages, settings and network rules from a snapshot.
  • 05Includes a home screen launcher with no internet permission.
  • 06Offers a dry-run mode for every script.

Use cases

  • Cleaning up a new Fire TV stick or Fire TV Edition TV that shows ads on the home screen.
  • Stopping a TV from sending viewing data to the manufacturer.
  • Replacing a cluttered Android TV home screen with a minimal one.

Quick start

  1. 1

    Connect ADB to the TV

    adb connect <tv-ip>:5555
  2. 2

    Check the device shows as authorized

    adb devices
  3. 3

    Run the read-only preflight check

    ./scripts/preflight.sh
  4. 4

    Answer what to keep, then run the full pass

    ./scripts/configure.sh

Things to know

  • Only works on Fire OS and Android TV/Google TV; Samsung, LG, Roku and similar TVs are not supported.
  • Requires ADB debugging enabled on the TV and a machine with adb; the scripts reboot the TV twice.
  • Uninstalled streaming apps stored in /data cannot be restored by the script and must be reinstalled from the store.
  • Tested on one Fire OS 7 device; other OS versions may need different package lists.

Topics

FAQ

What is dumbtv?
Shell scripts that debloat Fire TV and Android TV sets over ADB without root, removing ads, telemetry and unwanted apps, all reversible. dumbtv is a set of scripts that runs from another computer over ADB to strip ads, telemetry and unwanted preinstalled apps from a TV. It needs no root and does not write to /system. It disables roughly 65 tracking and promotional packages, turns off ad tracking and voice features, and runs an on-device DNS filter that blocks Amazon telemetry and OTA endpoints.
Is dumbtv free to use? What license does it have?
dumbtv is open source under the Other license. Check the license terms before using it in commercial products.
Is dumbtv still maintained?
Actively maintained. The last commit to dumbtv was on Oct 19, 2026.
What can I use dumbtv for?
Cleaning up a new Fire TV stick or Fire TV Edition TV that shows ads on the home screen. Stopping a TV from sending viewing data to the manufacturer. Replacing a cluttered Android TV home screen with a minimal one.
How do I install dumbtv?
Connect ADB to the TV: adb connect <tv-ip>:5555 Check the device shows as authorized: adb devices Run the read-only preflight check: ./scripts/preflight.sh Answer what to keep, then run the full pass: ./scripts/configure.sh
Where can I get dumbtv?
The source code and installation instructions are on GitHub: https://github.com/humblemuzzu/dumbtv

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects