shipstuff / tvunlock

# TV Unlock
A practical toolkit for cleaning up LG webOS TVs and installing a simpler home screen. Designed for a TV owner working with a coding agent.
It includes a minimal launcher, a rooted-TV home router, an LG Home escape shortcut, a read-only audit, and a plan-based cleanup tool. **It does not automatically root a TV.**
## Start here — for agents
**Read AGENTS.md, then docs/START_HERE.md before connecting to a TV or changing anything.**
An owner can give their agent this prompt:
> Read this repository's README, AGENTS.md, and docs/START_HERE.md. Help me audit and clean up my own LG webOS TV. Discover my exact model and firmware, ask which apps I use, and show me a specific cleanup plan. Keep my network details, credentials, account data, and device identifiers in ignored local state. Start with reversible ad settings. Treat rooting, deletion, and global home-screen changes as separate decisions, and carry out work I've already authorized without repeatedly asking.
Do not copy the reference TV's compatibility assumptions to a different model. Do not treat the optional-app recipe as a deletion list.
## What it can do
- Disable supported LG Home Promotion, Content Recommendation, Live Promotion, Screensaver Promotion, and Live Plus settings.
- List installed apps and remove only apps the owner explicitly selects.
- Identify large retail Store Demo videos and optionally remove the audited files after the owner's backup/deletion decision.
- Build a dark, remote-friendly launcher with configurable app and HDMI rows and proper app logos.
- On a compatible rooted TV, map **Home → Launcher** and **hold 1 → LG Home**.
- Open Launcher after startup, standby wake, and automatic returns to LG Home, including after AirPlay ends. Intentional visits to LG Home remain available.
- Restore the prior Home-key and hold-1 configuration.
The automatic home integration runs on the TV. The computer can be off afterward. LG's native Home may briefly appear before the router opens Launcher. An active casting session is exempt from startup redirection; screen-saver wake does not intentionally interrupt the foreground app.
This disables LG interface promotions. It does **not** remove video ads delivered by YouTube, Hulu, Peacock, or other streaming services. Freeing storage is measurable; a speed improvement is not guaranteed.
## Compatibility
The original integration was tested on **LG OLED65B2AUA**, firmware **33.31.75**, **webOS 25 / SDK 10.3.2**. See the compatibility report for the rooting entry point and tested behaviors. Other models and firmware need their own capability checks.
| Access | Available workflow |
| --- | --- |
| Normal TV settings | Disable interface promotions and remove apps through LG's UI |
| LG Developer Mode | Sideload and manually open the launcher; sessions need renewal |
| Existing compatible root + Homebrew Channel | Root SSH audit/cleanup tools, global Home remapping, automatic return/startup routing |
The cleanup tools require Python