humblemuzzu/dumbtv
humblemuzzu/dumbtv has 2,017 GitHub stars and 229 forks. GitHot measured +11 stars in 24 hours and +132 in 7 days. Last checked 2026-11-09 23:17 UTC. Last push 2026-10-27.
ADB를 통해 Fire TV에서 광고, 추적 기능 및 불필요한 요소를 제거할 수 있으며, root 권한이 필요하지 않습니다. 모든 작업을 되돌릴 수 있습니다. 자체 오픈 소스 홈 화면이 함께 제공됩니다.
측정된 스타 증가
- in 24h
- +11
- in 7 days
- +132
- in 15 days
- 업데이트 지연
- in 1 month
- 업데이트 지연
서로 겹치는 기간의 순증가량이며 일별 합계가 아닙니다. 측정값이 없으면 비워 둡니다. 스타는 관심도를 나타내며 품질을 보장하지 않습니다.
README.md
Original
Your TV should do what you paid for.
Ads, tracking and clutter out of your Fire TV. Your apps and HDMI inputs stay.
dumbtv.org · Get started · What it blocks · Devices · Get help
As seen in TechCrunch · TechRadar · Tom's Guide · Gizmodo · XDA · It's FOSS · and more than 150 others
The story
I had a Fire TV Edition television that had become painful to use. Menus lagged, apps took ages to open, and the home screen was mostly ads. When I looked, it had 129 MB of free memory, and much of the rest went to apps that started on their own and to Amazon services that report what you watch.
So I asked a coding agent to clean it up over ADB, and posted what happened. People asked for the scripts, so I put them here and shared them. Since then, owners of about twenty other TVs and sticks have run it and sent back what they found.
dumbtv is that cleanup, made safe to run on someone else's TV.
What it does
On a Fire TV stick, Cube or Fire TV Edition television, from your computer, with no root:
- Removes the ads and tracking. Disables Amazon's sponsored rows, ad services, screen fingerprinting (ACR), telemetry and experiments, and turns off ad tracking and usage reporting.
- Blocks what cannot be disabled. A small open-source DNS filter on the TV stops Amazon's telemetry and automatic updates from reaching their servers. Everything else, including your streaming apps, works as before.
- Replaces the home screen with dumbtv home: your apps, your inputs and a clock. 95 KB, open source, no internet access.
- Leaves your apps alone. Nothing you watch is removed unless you name it.
- Can all be undone with one command.
Quick start
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.
What you choose
configure.sh asks, and nothing is decided for you:
| Question | Default |
|---|---|
| Do you watch Prime Video? | yes: its servers stay reachable |
| Keep Alexa and the voice button? | yes |
| Replace Amazon's home screen with dumbtv home? | yes |
| Run the DNS filter on the TV? | yes |
| Any apps you want removed? | none |
| Replace the YouTube app with SmartTube (no ads, no Shorts)? | no |
Your answers are saved in dumbtv.conf; run configure.sh again to change them.
What changes
| Amazon packages | About 50 disabled: ads, sponsored content, ACR, telemetry, crash and usage uploads, experiments, update nags. Disabled, never deleted. |
| Protected packages | The few Amazon will not let anyone disable lose background running; the DNS filter blocks what they upload. |
| Settings | Ad tracking limited, interest-based ads off, usage reporting off, home-screen autoplay off. |
| DNS | personalDNSfilter runs on the TV and blocks about 400 Amazon telemetry, ad and update hosts. YouTube, the Appstore and your other apps are not blocked. |
| Home screen | dumbtv home instead of Amazon's: no promo tiles, no sponsored rows. |
| Your apps | Untouched. |
How it works explains each part and why it is needed. dumbtv.org/blocked lists every package, what it does and what you lose without it.
dumbtv home
| Rows | Grid | Options |
|---|---|---|
 |
 |
 |
A home screen that shows your apps and your HDMI inputs, and nothing else. Accent colours, tile sizes, rows or a grid, wallpapers, adaptive backgrounds, renaming and hiding, and the icons of an icon pack you install, all from the remote. HOME lands on it in a fraction of a second.
It is plain Java with no libraries and no internet permission, so it cannot send anything anywhere. On Fire OS 7 and 8 its only permission is run at startup, used to restart the DNS filter when Android kills it. It works on its own, without the rest of dumbtv:
adb connect <tv-ip>:5555
./launcher/install.sh
launcher/README.md covers the settings, wallpapers, icon packs and how it takes over the HOME button.
Tested on
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.
Android TV and Google TV reports, run by hand from the lists in
data/androidtv/:
For a full Android TV and Google TV tool, see cleanyourtv. Samsung, LG, Roku and other TVs give owners no way in; docs/OTHER-TVS.md explains each one and what you can still do.
Your TV not here? Run it, then ./scripts/contribute.sh. It writes the report
for you. CONTRIBUTING.md has the details.
Undo
./scripts/restore.sh
It re-enables every package, clears the app and network rules, puts back the
settings the TV had before (from the snapshot preflight.sh takes), removes the
filter and gives HOME back to Amazon. An app you asked to have uninstalled comes
back from the Appstore.
Good to know
- Nothing is written to
/system, the part of the TV whose modification bricks it. A factory reset removes everything dumbtv did. - Fire OS updates are blocked while the DNS filter runs, since an update would switch a lot of this back on. The FAQ explains how to update anyway.
- It cannot replace Fire OS. The boot chain is locked by Amazon. Here is why.
- YouTube ads can't be blocked by DNS. They come from the same servers as the videos. docs/YOUTUBE.md explains, and what to use instead.
Documentation
| dumbtv.org | the website: guides, every package, every device |
| How it works | each part and why it is needed |
| Troubleshooting | symptoms and fixes |
| FAQ | updates, Prime Video, factory reset, is this legal |
| Other TVs | Android TV, Samsung, LG, Roku and the rest |
| YouTube | why its ads cannot be blocked, and SmartTube |
| Why not replace the OS | the locked boot chain |
| dumbtv home | the launcher |
| Device catalog | per-model notes |
| AGENTS.md | instructions for coding agents |
| Press | coverage |
Thanks
To everyone who tested a TV, wrote code, or reported a problem. dumbtv works on all the devices above because of you.
Code, fixes and device reports: @fabricio00101, @MrVoicer, @Jovci, @niz-coder, @centsandcode, @maam00, @alfibi, @theChef613, @rachit-jain, @daviavmello, @yuriwc, @lsukev, @dchuk, @gerardo-galvez-hl, @koconnorgit, @pfTheTrial, @frogu, @podulator, @tkightly, @OSikorsky, @nolanvargas, @harupong, @gtalusan, @B3NR1S, @bglaszcz, @murilaiooo, @dnpkuk, @timcunningham-sv, @iotemylabs, @aswinaasokan18-spec, @edrmundy, @MarioMartReq, @ravishan16, @jonathanrzarzuela-cloud, @Loadedrakeman, @ryanlucht, @tharun634, @NimorM, @RabeJonas, @Prathamesh913, @zaco-tm, @NeutronZero, @adi-c, @derkstample, @KasperHonore, @damsma, @arielvieira, @stedrow, @zekesax
Bug reports: @gleesonb, @dennus280-ship-it, @FyllyMan, @nairyash, @PWannop, @jt-at-home, @thearchivist9778-ai, @GrackleCrow, @MisterKOak
And to the projects dumbtv stands on: personalDNSfilter by Ingo Zenz, HaGeZi's DNS blocklists, SmartTube by Yuriy Liskov, and cleanyourtv by @Gathin23 for Android TV and Google TV.
Legal
dumbtv changes settings on a device you own, through the developer tools the manufacturer ships. It does not bypass DRM, unlock anything or touch anyone's account. Fire TV, Fire OS, Alexa and Prime Video are trademarks of Amazon; dumbtv is not affiliated with or endorsed by Amazon. Use it at your own risk.
Licence
Scripts, docs and the launcher are MIT. The device catalog is CC BY-SA 4.0.
dumbtv bundles none of these, but downloads them when you ask for them: personalDNSfilter (GPL-2.0) from F-Droid, HaGeZi's Amazon tracker list (GPL-3.0), and SmartTube (MIT) from its own releases.
관련 프로젝트 살펴보기
trimstray/the-book-of-secret-knowledge
영감을 주는 목록, 매뉴얼, 치트시트, 블로그, 팁, 원라이너, CLI/웹 도구 등을 모은 컬렉션.
257,431 스타Hack-with-Github/Awesome-Hacking
해커, 펜테스터, 보안 연구자를 위한 다양한 Awesome 목록 모음.
125,103 스타swisskyrepo/PayloadsAllTheThings
웹 애플리케이션 보안과 모의 침투 테스트/CTF에 유용한 페이로드 및 우회 방법 목록.
82,542 스타caddyserver/caddy
빠르고 확장 가능한 멀티플랫폼 HTTP/1-2-3 웹 서버이며, 자동 HTTPS를 지원합니다
78,935 스타