llms.txt

# dumbtv

> Debloat a smart TV that lets you in — Fire OS and Android TV / Google TV — over
> ADB without root: disable ad, tracking, Alexa and OTA packages, deny background
> work to the ones the vendor protects, install an on-device DNS filter, and
> replace the home screen with the repo's own open-source launcher. Reversible.
> Tizen, webOS, Roku and the rest of the closed platforms cannot be opened this
> way; `docs/OTHER-TVS.md` says why, and what is being worked on.

Agents: read `AGENTS.md`, interview the user, then run `./scripts/preflight.sh`,
`./scripts/configure.sh`, `./scripts/all.sh`, `./scripts/verify.sh`.

## Docs

- [AGENTS.md](AGENTS.md): the operating contract — guardrails, run order, success criteria, recovery table
- [README.md](README.md): what it changes, quickstart, what it explicitly cannot do
- [launcher/README.md](launcher/README.md): dumbtv home, the repo's own zero-permission launcher, and how it takes HOME on Fire OS
- [docs/HOW-IT-WORKS.md](docs/HOW-IT-WORKS.md): the five mechanisms and their limits
- [docs/GOTCHAS.md](docs/GOTCHAS.md): every failure mode found while building this
- [docs/OTHER-TVS.md](docs/OTHER-TVS.md): which TVs can be opened, which cannot, and what is being worked on
- [docs/YOUTUBE.md](docs/YOUTUBE.md): why YouTube ads cannot be blocked at the network, and the client that replaces the app
- [docs/WHY-NOT-REPLACE-OS.md](docs/WHY-NOT-REPLACE-OS.md): the bootloader and dm-verity wall
- [docs/FAQ.md](docs/FAQ.md): revocation, updates, Prime Video, legality

## Machine-readable

- [catalog/devices/](catalog/devices/): one YAML per platform or model — developer-mode path, where the IP is, which dialogs block automation, which data files apply
- [catalog/schema.json](catalog/schema.json): shape of those files
- [data/apps.txt](data/apps.txt): app name to package id
- [data/fireos/](data/fireos/): package, protected and never-disable lists
- [data/blocklists/](data/blocklists/): extra hosts, verification hosts, list provenance

## Optional

- [skills/firetv-debloat/SKILL.md](skills/firetv-debloat/SKILL.md): the same procedure as a loadable skill