Repolode
chiotas

chiotas/lightkeeper

A calm Home screen for older LG webOS TVs, showing time, weather, and a row of apps and inputs, designed to run beside GlassHouse.

Stars
92
Forks
5
Open issues
3
Last commit
yesterday

What is it?

Lightkeeper replaces the Home screen on rooted LG TVs running older webOS versions. It shows the time, the weather for one city, and a row of apps and inputs over a background picture, and it keeps LG's ads and suggestions off the screen. The Home key opens it, it can appear when the TV switches on, and it is configured through a settings page served from the TV and opened on a phone or computer.

It is designed to sit beside GlassHouse, which provides the remote-key filter used to hand the Home key to Lightkeeper. The project requires a rooted TV with the Homebrew Channel, and it is installed through the Homebrew Channel's repository, GlassHouse's app installer, webOS Dev Manager, or an SSH script. It was built and tested on an LG C1 running webOS 6.5.3, and users have reported it on other models.

The settings page lets you pick tiles and their logos or icons, choose clock style and size, set a weather city, pick background pictures, and decide which key opens the launcher. Weather data comes from Open-Meteo, and the Home works offline apart from weather.

Key features

  • 01Shows the time, one city's weather, and a row of apps and inputs over a picture.
  • 02Hides LG's ads and suggestions from the Home screen.
  • 03Opens with the Home key and can appear when the TV turns on.
  • 04Configured from a settings page on a phone or computer, with a live preview.
  • 05Offers white logos for many streaming services and consoles, or the apps' own icons.
  • 06Supports custom background images and a choice of clock styles.

Use cases

  • Replacing LG's default Home on an older webOS TV that is rooted and running GlassHouse.
  • Keeping a calm, ad-free launcher on a TV used as a living-room display.
  • Adding web page shortcuts and inputs to the TV's home row.
  • Showing the weather and time for a city in a different time zone.

Quick start

  1. 1

    In the Homebrew Channel, add Lightkeeper's repository using the apps.json URL from the README

  2. 2

    Find Lightkeeper in the channel's list and install it

  3. 3

    Open Lightkeeper once from the TV's apps, then set it up from a phone at http://<your-tv>:8090

Things to know

  • Requires an LG webOS TV that is rooted and runs the Homebrew Channel.
  • Needs GlassHouse installed and running to hand the Home key to Lightkeeper.
  • Built for older webOS TVs; newer models are served by GlassHouse's own Home.
  • Tested mainly on one LG C1, with other models only partly reported.

Topics

FAQ

What is lightkeeper?
A calm Home screen for older LG webOS TVs, showing time, weather, and a row of apps and inputs, designed to run beside GlassHouse. Lightkeeper replaces the Home screen on rooted LG TVs running older webOS versions. It shows the time, the weather for one city, and a row of apps and inputs over a background picture, and it keeps LG's ads and suggestions off the screen. The Home key opens it, it can appear when the TV switches on, and it is configured through a settings page served from the TV and opened on a phone or computer.
Is lightkeeper free to use? What license does it have?
lightkeeper is open source under the MIT license. Check the license terms before using it in commercial products.
Is lightkeeper still maintained?
Actively maintained. The last commit to lightkeeper was on Nov 6, 2026.
What can I use lightkeeper for?
Replacing LG's default Home on an older webOS TV that is rooted and running GlassHouse. Keeping a calm, ad-free launcher on a TV used as a living-room display. Adding web page shortcuts and inputs to the TV's home row. Showing the weather and time for a city in a different time zone.
How do I install lightkeeper?
In the Homebrew Channel, add Lightkeeper's repository using the apps.json URL from the README Find Lightkeeper in the channel's list and install it Open Lightkeeper once from the TV's apps, then set it up from a phone at http://<your-tv>:8090
Where can I get lightkeeper?
The source code and installation instructions are on GitHub: https://github.com/chiotas/lightkeeper

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects