Find your next open-source project

Search by name, purpose, or keyword — or paste a GitHub repository URL

ChrisTitusTech/lg-debloat

System Tools

A Python CLI that trims promotions and background apps on rooted LG webOS TVs, with a restorable state record.

124
0
Python
MIT
new today

What it does

This is a command-line tool for reducing LG promotions and unused background activity on a rooted LG webOS TV. It hides selected built-in apps, disables supported promotion settings, and stops selected apps from preloading, while keeping Plex, YouTube, Developer Mode, Homebrew, and TV inputs available. It does not uninstall apps or block ads inside streaming services.

The script keeps a private state file so changes can be undone. It runs from your computer and talks to the TV over SSH.

Quick start

Requirements: a rooted LG webOS TV with working root SSH access, Python 3.9+ and OpenSSH on your computer. Developer Mode alone is not sufficient; see the connection and setup guide for help.

Download the script from the latest release and run a read-only plan first:

mkdir -p lg-debloat
cd lg-debloat
curl -fL --output lg-debloat.py https://github.com/ChrisTitusTech/lg-debloat/releases/latest/download/lg-debloat.py
python3 lg-debloat.py --version
python3 lg-debloat.py plan --host tv

Replace tv with the TV's IP address or SSH alias. SSH must already trust the TV's host key and connect with a key without a password prompt; connection options are covered in the script prerequisites. Review the plan, then apply and check status:

python3 lg-debloat.py apply --host tv
python3 lg-debloat.py status --host tv

Keep the generated private/universal-state.json because it holds the original settings needed to undo the run, and do not share it. To undo, run python3 lg-debloat.py restore --host tv. The full script guide covers dry runs, keeping specific apps, separate backups for multiple TVs, and recovery after errors.

Constraints

Model support varies. Read-only planning has been tested on webOS 4.x; applying and restoring changes have automated tests but have not been verified on a real TV with this script, according to the README. The optional guides on a custom Home screen, AirPlay disabling, and firmware update blocking are not performed by the script itself. The project is MIT licensed.

HotRepo's take

The project appeared on the Python new-project list for 2026-11-18 with 100 stars gained over roughly 15 hours and 100 total stars, with no recorded position on the all-language daily ranking. Only one snapshot is available, so the data supports initial interest in the release but not a trend. The README is candid that apply and restore are untested on hardware, so users with a rooted TV should start with the read-only plan command and keep the generated state file before changing anything.

Written by AI from the project's README, updated . The project's own docs are the source of truth.

You might also like

  1. OmkarK97/webos-vibehackReplaces LG webOS's ad-filled home screen with an Apple TV-style launcher, aimed at LG TV owners willing to set up Developer Mode.JavaScript284
  2. ecklf/lg-lumaA native Home replacement launcher for rooted LG webOS TVs, offering app tiles, input icons, backgrounds and recent-app switching.Rust396
  3. rorygallagher2024/glasshouseA self-hosted dashboard, privacy control and debloating suite for rooted LG webOS TVs, with an optional Home Assistant MQTT bridge.JavaScript1,957
  4. mbsintegrations/LG-TV-HA-Home-LauncherUse an LG webOS TV as a dashboard for Home Assistant, with a local IPK builder and optional Home-button helper.JavaScript77
  5. piermark/omarchytvA tiling, keyboard-style home screen that replaces the stock launcher on Android and Google TV, plus webOS experiments.Java121