webOS Home
An animated pixel room, a clock, a quote, and four app shortcuts replace the stock shelves.
- Add-on
- Beta
- Medium brick risk
- Reversible
This project hasn't been claimed by its maintainer yet, so its details come from the community. Is it yours? Claim it
A native QML Home screen for rooted webOS, with an animated room, clock, quotation, and four application shortcuts.
Includes firmware hash guards, local Home backups, a timed trial, explicit boot activation, owned rollback, a paired remote/capture helper, and Tailscale setup instructions. The README and agent guide describe how to adapt it to another device.
The original UI ran on webOS Hub22, SDK 7.5.9-36, firmware 04.56.75. The extracted public installer passes 18 deployment tests and UI logic checks in a fresh clone and GitHub CI. Its companion helpers passed root-state, inventory, display-capture, and remote-button checks on the original device. A fresh end-to-end deployment of this exact installer remains untested.
The attached GIF and MP4 files are actual display captures. The refreshed dashboard demo shows all four character scenes, with a name visible throughout. Hari appears in 60% of frames; Adi and Aadith appear in the rest. Bengaluru temperature and weather conditions remain visible with the owner's permission. The stock comparison's hardware badge stays masked. Existing artwork is retained.
Code and documentation use MIT. See NOTICE.md for artwork, characters, application logos, and quotation rights. See docs/comparison.md for measured results and test limits.
Before you start
- How hard is it?
- HardUses the command line or developer tools.
- What you need
- Comfort with the command line
- A computer
- Another hack installed first
- Can it break my device?
- Small chance of trouble, with a way to recover.
- Can I undo it?
- Yes. You can go back to the official software.
Did it work for you?
Did webOS Home v0.1.0 work on your LG OLED C3?
No reports yet for v0.1.0.
One-tap reports from owners. Bricked reports are checked before they count.
Compatibility
Devices: LG OLED C3.
No compatibility information yet.
Getting started
From the project's README ("Start here"):
Install Python 3.10+, OpenSSH, Bun, and Node.js 20+ on your computer. The TV needs a working root shell before the deployment tools can help.
bun install --frozen-lockfile bun run verify mkdir -p .local cp config.example.json .local/config.json
Set the SSH host, private key path, and verified host key in your local configuration. Keep the supplied profile only if the target hashes match. Then follow the setup guide. It covers the backup, timed trial, visual check, activation, and rollback in order.
For a preview of the files without a TV connection:
python3 scripts/webos.py --config config.example.json build
For access from another network, follow the Tailscale guide. The TV runs its own node. It needs no gateway computer or public SSH port.
Risk and recovery
- Brick risk
- Medium
- Reversible
- Yes
- Requires opening the device
- No
From the project's README ("What changes"):
The installer places the replacement QML and assets under /media/developer/native-home. A bind mount covers one firmware QML file. The firmware file and Home executable stay intact. Rollback disables the owned startup hook, removes the mount, and restarts Home.
The public installer starts with a timed trial. It installs a permanent boot hook only after you inspect the screen and confirm the result. Rooting and Tailscale enrollment are separate steps. It does not remove applications or disable services on your behalf.
The UI supports remote focus, app launch, a full-room view, Play/Pause for motion, and optional weather. Personal greetings, weather coordinates, app IDs, and artwork can be set in an ignored local config. The default has no personal names and makes no weather requests. The demonstration uses the owner's personalised theme.
Releases
| Version | Name | Released |
|---|---|---|
| v0.1.0 | —Latest | 20 October 2026 |
Credits, license and support
- License
- MIT