Skip to content

About

A calm, ad-free CleanFrame home screen for rooted LG webOS TVs, plus a reversible debloat and memory tune-up.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

LG webOS Clean Home

A calm, ad-free home screen for rooted LG webOS TVs, plus a faster TV. CleanFrame's photo and glass-dock home screen, ported from Samsung to LG, on top of a reversible debloat and memory tune-up.

webOS 25 Rooted Reversible License

The home screen: a coastal photograph, the clock with Inputs and Free memory at the top left, All apps, Home settings and TV settings at the top right, and a frosted glass dock with YouTube, HDMI 1, Browser, Media, LG Apps and Homebrew

Before and after

LG's own Home This project
LG's stock webOS Home with promotions, sports and gallery tiles The CleanFrame home screen on the same TV
Banners, "suggestions", sports, shopping and LG Gallery+ tiles, and tracking services running in the background. One photograph, the time, your apps. No ads or recommendations, and nothing extra running.

What you get

  • A real CleanFrame home screen. This is CleanFrame's own code (layout, glass dock, photos, settings), with only its Samsung parts rewritten for LG. The dock slides left and right, there's no grid underneath, and it opens every time you press Home.
  • Top controls:
    • left: Inputs (HDMI) and Free memory (closes everything running in the background and shows how much RAM you got back)
    • right: All apps, Home settings (this screen's own look options) and TV settings (LG's settings)
  • Hold OK on any app for a menu: Open · Move · Move to start · Remove from Home / Add to Home · Uninstall · Cancel.
  • No LG Home at boot. With Quick Start+, power on resumes straight into this screen. After a full restart the TV opens your last input (your set-top box, for example) instead of LG's Home, and this screen takes over once root has started, about a minute in.
  • A faster TV:
    • LG's log uploads and recommendation services are stopped.
    • LG no longer keeps apps preloaded in the background.
    • 384 MB of compressed RAM (zram) is added, so apps get pushed out to slow flash less often.
    • The flash storage is trimmed once a week.
  • Install any webOS app (.ipk) from your PC in one command, or from the Homebrew Channel.
  • Everything is reversible. Nothing on LG's read-only system partition is touched; changes live in RAM and are re-applied by a boot hook.
Hold OK on an app Move an app along the dock
The hold menu: Open, Move, Move to start, Remove from Home, Uninstall, Cancel Moving IPTV along the dock with a hint above it

Tested on

TV Firmware Root
LG 43UR7500PSC (UR75, 2023, 1.2 GB RAM) webOS 25 / TV Lite 10.3.1 (33.31.61) Homebrew Channel 0.7.3

Other webOS 23–25 TVs should work, since the parts that differ between models are detected at run time, but test carefully on yours.

Warning

This is for rooted TVs and you use it at your own risk. Keep the Homebrew Channel's firmware-update block on: an LG update can remove root. Never write to system partitions (kernel, rootfs, tvservice); this project never does.


Install guide

You need a Windows PC on the same network as the TV, with OpenSSH (built into Windows 10/11), Git and Python 3.

1. Root the TV and turn on SSH
  1. Root it with RootMyTV or the method for your firmware. The Homebrew Channel gets installed.
  2. On the TV, open Homebrew Channel → ⚙ Settings → turn SSH Server on. Leave Block system updates on.
  3. Find the TV's IP address under Settings → General → Network. It's a good idea to reserve it in your router.
2. Give your PC an SSH key for the TV

In PowerShell:

ssh-keygen -t ed25519 -N '""' -f $env:USERPROFILE\.ssh\lgtv_root
type $env:USERPROFILE\.ssh\lgtv_root.pub | ssh root@<TV-IP> "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"

The password it asks for is the Homebrew Channel default, alpine, unless you changed it. Nothing appears on screen while you type it. Once the key is in, the password is no longer used.

3. Get this project and tell it your TV's address
git clone https://github.com/Anexeus/lg-webos-clean-home
cd lg-webos-clean-home
$env:LGTV_IP = '<TV-IP>'      # or pass -TV <TV-IP> to every command

If PowerShell refuses to run scripts: Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.

4. Speed and privacy tweaks
.\lgtv.ps1 deploy      # copies the scripts and the boot hook to the TV
.\lgtv.ps1 apply       # applies them now (they re-apply by themselves ~1 minute after every boot)
.\lgtv.ps1 status

What gets stopped or changed is listed in What the tweaks do, and you can adjust it in tv/lgtv-tune.conf. For blocking LG's ad and tracking servers, also install Life's Good Without Spying from the Homebrew Channel.

5. Install CleanYourTV for webOS (the plumbing)

CleanYourTV for LG webOS provides the small service and the boot scripts that make a web page the TV's Home. Its own debloat and Input-key features stay off, because step 4 already covers that.

ssh -i $env:USERPROFILE\.ssh\lgtv_root root@$env:LGTV_IP "curl -fsSL https://raw.githubusercontent.com/lasharor/cleanyourtv-WebOS/main/install.sh | sh"
ssh -i $env:USERPROFILE\.ssh\lgtv_root root@$env:LGTV_IP "sh /media/developer/apps/usr/palm/services/com.cleanyourtv.manager.service/bootstrap.sh install --no-debloat --no-input-key"

The screen blinks once. If the new Home doesn't come up, it puts LG's Home back by itself.

6. Make CleanFrame the home screen
.\lgtv.ps1 cleanframe

This backs up CleanYourTV's own page, puts CleanFrame in its place and reloads Home. If a CleanYourTV update ever replaces the page, the boot hook puts CleanFrame back.

7. Never see LG's Home at boot

On the TV, find Power On Screen (on webOS 25 it's under Settings → General → System → Additional Settings) and set it to Recent Input. This is the homeAutoLaunch setting. With it, a full restart opens your last input (your set-top box, say) instead of LG's Home, and the new home takes over when root has started. Also keep Quick Start+ on, so pressing the power button resumes in seconds and doesn't restart at all.


Using it

Remote What it does
Left / Right Move along the dock
OK Open the app
Hold OK App menu: Open, Move, Move to start, Remove from / Add to Home, Uninstall (asks first)
Up Top controls: Inputs · Free memory · All apps · Home settings · TV settings
Back (on Home) Offers the LG Content Store
Home Always brings this screen back, also from HDMI or any app

Installing apps

  • From the Homebrew Channel on the TV: YouTube AdFree, Kodi, Jellyfin, Moonlight, RetroArch and more.

  • Any .ipk from your PC:

    .\lgtv.ps1 install-ipk C:\path\to\app.ipk
    .\lgtv.ps1 apps                  # what can be uninstalled
    .\lgtv.ps1 uninstall-app <id>

LG TVs can't run Android apps (.apk), so apps like Brave, which only exist for Android, can't be installed.

What the tweaks do

Area Change Why
Telemetry Stops remotelogger and service-logger They collect logs and upload them to LG
Suggestions Stops contentminer It builds the recommendation rows
Preloading Switches off LG's background preload of the browser, voice search and guide On 1.2 GB of RAM, preloads push your own apps out of memory
Memory 384 MB zram (lz4), used before the flash swap Idle pages are compressed in RAM instead of written to slow flash
Storage Weekly fstrim of the data partitions LG never trims, so the flash slows down over time

How it works

flowchart LR
    A[Power on] --> B[LG logo]
    B --> C{Power On Screen}
    C -- Recent Input --> D[Last input<br/>e.g. set-top box]
    C -- Home --> E[LG Home]
    D --> F[Homebrew Channel starts<br/>init.d boot hooks ~45-60 s]
    E --> F
    F --> G[CleanYourTV mounts CleanFrame<br/>over LG's Home, in RAM]
    G --> H[CleanFrame home]
    F --> I[lgtv-tune: debloat, zram,<br/>preload, self-repair]
    H -- Home key --> H
Loading
  • CleanFrame (look/cleanframe-lg/) is CleanFrame's web app. device.js is rewritten to call the CleanYourTV service on the TV (127.0.0.1:8765) for the app list, launching, uninstalling, HDMI inputs and closing apps. main.js is ported by scripts that are re-runnable on a fresh copy of CleanFrame.
  • CleanYourTV bind-mounts the page over LG's Home at boot, so the Home key, HDMI exits and "back to Home" all land on it.
  • lgtv-tune (tv/) is a boot hook in /var/lib/webosbrew/init.d. All of its changes are in RAM.

Undo

To remove Command
Booting into the last input Power On Screen → Home
CleanFrame (back to CleanYourTV's page) .\lgtv.ps1 cleanframe-undo
LG's own Home Open the CleanYourTV app → switch off "CleanYourTV as Home"
All tweaks and scripts .\lgtv.ps1 remove, then restart the TV

FAQ

Will the new home always come back after HDMI, standby or a restart?
  • Home key, leaving an app, leaving HDMI: yes, always. LG's Home is this page now.
  • Standby (Quick Start+ on): the TV resumes where you left it, so you're back on this home screen within seconds.
  • Full restart or power cut: the LG logo, then your last input (with Power On Screen set to Recent Input), then this screen about a minute in, once the Homebrew Channel has started. The LG logo itself can't be removed; it's drawn before anything rootable runs.
Why does a cold boot take about a minute to show the dock?

The Homebrew Channel, which runs all root scripts, is started by webOS about 45 seconds after power on, and the switch to the new Home needs root. On a test boot the new home was in front at 64 s. Something showing earlier isn't possible: LG's boot manager only opens LG's Home or a real input (HDMI, AV, antenna) at boot. It refuses apps, which was tested with a splash app. Keep Quick Start+ on and you'll rarely see a cold boot at all.

luna-send prints nothing over SSH

On this firmware it only prints to a terminal. The scripts wrap it in script -q -c "luna-send …" /dev/null.

Project layout

lgtv.ps1                  PC control script (deploy, apply, cleanframe, install-ipk, ...)
tv/                       everything that runs on the TV
  lgtv-tune.conf          settings for the tweaks
  tune.sh / undo.sh       apply / revert the tweaks
  cleanframe.sh           install CleanFrame as the Home page (with backup and self-repair)
  ipk.sh                  install / remove apps through LG's installer
  90-lgtv-tune            the boot hook
look/
  cleanframe-lg/          CleanFrame, ported to LG (the home screen)
  port_cleanframe.py      Samsung -> LG port of main.js
  cleanframe_features*.py Inputs, Free memory, Home/TV settings, hold-OK menu
  make_cleanframe_marks.py  white app symbols in CleanFrame's style
  build_ipk.py            builds a webOS .ipk from an app folder
  theme/ icons*/ ...      an alternative look for CleanYourTV's own launcher
docs/images/              screenshots

Credits and licences

  • CleanFrame by Nathan Clark: the home screen (MIT, look/cleanframe-lg/LICENSE-CleanFrame.txt). Its photographs are under the Unsplash License and its fonts (Manrope, Geist, Newsreader) under the SIL OFL; see look/cleanframe-lg/THIRD_PARTY_NOTICES.md.
  • CleanYourTV for LG webOS by lasharor: the Home takeover service. It isn't included here; you install it in step 5. It was also the reference for the debloat, zram and trim ideas.
  • Homebrew Channel / webOS Homebrew and RootMyTV.
  • Brand marks (YouTube and others) belong to their owners. This project isn't affiliated with LG, Samsung or any streaming service.

Everything else in this repository is under the MIT License.

About

A calm, ad-free CleanFrame home screen for rooted LG webOS TVs, plus a reversible debloat and memory tune-up.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages