Ambient Home
A living lakeside home screen for LG webOS TVs: real sun, moon, weather and seasons, and a Home button that opens it. No root needed.
- Sideload / dev mode
- Alpha
- Low 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
Before you start
- How hard is it?
- HardUses the command line or developer tools.
- What you need
- Comfort with the command line
- A computer
- Can it break my device?
- Very unlikely to break anything.
- Can I undo it?
- Yes. You can go back to the official software.
Did it work for you?
Did Ambient Home work on your LG OLED C3?
No reports yet.
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 ("🚀 Get started"):
👀 Preview it on your computer
python3 -m http.server 8766 --bind 127.0.0.1 --directory prototype
Open and play: arrows move, Enter opens, Esc goes back. T changes the time of day, W the weather, S the season, D runs a day time-lapse, 0 shows the frame rate and H hides the help bar.
For Ambient Wallpaper, open : Enter hides or shows the clock, and a double-click fills the screen. It makes a calm second screen, too.
📺 Put it on your TV
You need an LG webOS TV with Developer Mode turned on (LG's Developer Mode app, signed in with a free LG developer account, and Key Server on), plus a computer on the same network with Node.js 22+ and Python 3.
- One-time setup: install LG's command-line tools inside the project and register your TV. The steps are at the top of scripts/tv-preview.sh.
- Try it as an app: scripts/tv-preview.sh installs Ambient Home as a normal Developer Mode app. The Home button still opens LG Home.
- Bring in your apps: run node scripts/tv-sync-apps.mjs , accept the prompt on the TV, then run step 2 again.
- Make it yours (optional): put personal settings in prototype/config.local.js. Git ignores this file, so your coordinates and app ids never leave your computer: HOMECONFIG.weather.latitude = 48.86; // your coordinates, for live weather HOMECONFIG.weather.longitude = 2.35; HOMECONFIG.apps.iptv.appId = 'your.iptv.app.id'; …
Risk and recovery
- Brick risk
- Low
- Reversible
- Yes
- Requires opening the device
- No
From the project's README ("🛟 Ways back to LG Home"):
Where How What happens 🎛️ Remote Hold Back for about a second LG Home opens once 🎛️ Remote Press Home three times quickly Home opens LG Home until you turn Ambient Home back on ⚙️ Ambient Home Settings → Home button opens → LG Home Switch whenever you like 💻 Computer scripts/tv-home.sh lg or scripts/tv-home.sh remove Switch back, or take everything off the TV 🧯 Safety net Helper stops answering, or button presses get lost The relay lets go of the remote and turns itself off
Credits, license and support
- License
- MIT