Reading the repo
Reading the repo
How to install on macOS
Take the ads, tracking and clutter out of your Fire TV over ADB, no root. Every step can be undone. Comes with its own open-source home screen.
Saved setup from 7 h ago
Will it work on my device?
Each row is a report from the person who ran it. tested means the whole pass ran
and verify.sh passed on that device. dumbtv.org/tv has
every model with its menu paths and quirks.
| Device | Fire OS | Status | Tested by | |---|---|---|---| | Fire TV Stick 4K, 1st gen (AFTMM) | 6.7 | tested | @niz-coder | | Insignia Fire TV Edition (AFTEAMR311) | 6.7 | tested | @gtalusan | | Toshiba 50LF621U19, 55LF711U20 Fire TV Edition (AFTKMST12) | 6.7 | tested | @ryanlucht, @zekesax | | Insignia NS-43DF710NA19 Fire TV Edition (AFTJMST12) | 6.7 | tested | @Muffy0906 | | Fire TV, 3rd gen (AFTN) | 6.2 | tested | @adi-c | | Grundig 50 UHD AGA Fire TV Edition (AFTEU014) | 7.6 | tested | @mzmonkey | | Fire TV Cube, 2nd gen (AFTR) | 7.7 | tested | @podulator | | Fire TV Cube, 3rd gen (AFTGAZL) | 7.7 | tested | @sakalliAI | | Amazon AFTALMO | 7.7 | tested | @TheiMacNoob | | Xiaomi L55M7-FVEU Fire TV (AFTANNA0) | 7.7 | tested | @jmcerrejon | | Fire TV Stick 4K Max, 1st gen (AFTKA) | 7.7 | tested | @harupong, @Elv1sh | | Insignia 50" F30 (AFTDCT31) | 7.7 | tested | @timcunningham-sv, @twwebb3 | | Onida 43" Fire TV Edition (AFTGRO001) | 7.7 | tested | @humblemuzzu | | Fire TV Stick HD 2024, Stick Lite 2020 (AFTSS) | 7.7 | tested | @RabeJonas, @Prathamesh913, @arielvieira | | Hisense 55QD65NF (AFTHA004) | 7.7 | tested | @stedrow | | Fire TV 4-Series 43" (AFTTI43) | 7.7 | tested | @ScottDavidCA, @dleslie | | TCL Fire TV (AFTSHN02) | 7.7 | tested | @scaongithub | | Ember 55, Fire TV Omni Mini-LED (AFTOMNA003) | 8.0 | tested | @zaco-tm | | Fire TV Stick 4K Max, 2nd gen (AFTKRT) | 8.1 | tested | @gerardo-galvez-hl, @derkstample, @aboubakrine, @s-razaq | | Fire TV Stick 4K Plus (AFTMA08C15) | 8.1 | tested | @edrmundy | | Fire TV Edition television (AFTOLCBC82) | 8.1 | tested | @koconnorgit, @iotemylabs | | Fire TV smart TV (AFTHY7ABBA) | 8.1 | tested | @bring-nirachornkul | | Fire TV Stick 4K, 2nd gen (AFTKM), RS8185 | 8.1 | tested | @Rouchekoff | | Amazon AFTNA1322D | 8.1 | tested | @1xretr0 | | Xiaomi TV F Pro 75 Fire TV (AFTBR92D74) | 8.1 | tested | @Jeff909Dev | | Hisense 55QD75SFC Fire TV (AFTCU9343B) | 14 | tested | @sockmonkey0223 | | Fire TV Stick, 3rd gen (AFTSSS) | 7.7 | partial | @B3NR1S | | Fire TV Stick 4K Max, 1st gen (AFTKA) | 7.6 | partial | @dchuk | | Fire TV Cube, 2nd gen (AFTR), PS7699 | 7.6 | partial | [@sant1ago](htt
…
You need a computer with adb
and about ten minutes. On the TV, turn on ADB: Settings → My Fire TV → About,
press OK on the device name 7 times, then Developer Options → ADB debugging.
The TV's IP address is under Settings → My Fire TV → About → Network (on a
Fire TV Edition television: Settings → Network, then the connected network).
With a coding agent (Claude Code, Codex, Cursor, Gemini and others): clone this repository, open the agent in it, and say:
Clean up my Fire TV. Its IP address is (the address from the Network screen).
It reads AGENTS.md, asks you a few questions, and runs the steps below.
By hand:
git clone https://github.com/humblemuzzu/dumbtv && cd dumbtv
adb connect <tv-ip>:5555 # press Allow on the TV
./scripts/preflight.sh # what the TV is and what would change; changes nothing
./scripts/configure.sh # a few questions
./scripts/all.sh # asks before each step, reboots the TV twice
./scripts/verify.sh # checks the result
Works from macOS, Linux and Windows (WSL or Git Bash). The same steps, one at a time, are at dumbtv.org/start.
Rather not do it yourself? Tell us about your TV and we will help.
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.
Compare yours with the README's “Tested on” list above before installing anything.
Needs Git: xcode-select --install
git clone https://github.com/humblemuzzu/dumbtv.git cd dumbtv
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 <tv-ip>:5555 # press Allow on the TV ./scripts/preflight.sh # what the TV is and what would change; changes nothing ./scripts/configure.sh # a few questions ./scripts/all.sh # asks before each step, reboots the TV twice ./scripts/verify.sh # checks the result
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.From the README.
./scripts/restore.sh
No reports for macOS yet.
Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.