Skip to content
taynotfoundPublic

About

A personal home screen for Google TV's.

Resources

Contributing

Stars

6 stars

Watchers

1 watching

Forks

 
 

Repository files navigation

Shore, a home screen for Google TV

Shore

A plainer home screen for Google TV.
Your apps, your HDMI devices and a photo you chose, with the time, the weather and a headline in the corner.

Website · Download · Wiki · Install · Discord

Support on Ko-fi GitHub Sponsors Discord

Shore's Home screen: the time, the weather, one headline and a dock of apps over a photo of the Golden Gate Bridge

Shore is a free, open-source launcher for Android TV and Google TV. It shows your apps, the devices plugged into HDMI and a photo you chose, with the clock, the weather and a headline on top. While music plays it opens the song full screen, with synced lyrics. Hold Home and you are back in Google TV.

It is a fork of Nathan Clark's CleanFrame. The interface is the original HTML/CSS app; a small Java shell runs it full screen and connects it to the TV. Shore is built and tested on a TCL 55C6KS, and people run it on other TVs too.

Note

Unofficial. Not affiliated with TCL, Google or any streaming service. Everything is reversible, and each step says how.

Install

You need a computer on the same Wi-Fi with Android platform tools (adb), once. Shore installs next to Google TV and removes nothing.

  1. On the TV, turn on developer options (Settings › System › About, press OK on Android TV OS build seven times) and USB debugging.

  2. Connect and install the APK from the latest release:

    adb connect <tv-ip>:5555
    adb install -r Shore.apk
  3. Turn on Settings › System › Accessibility › Shore Home button so Home opens Shore. On TCL sets, also allow auto start.

The Installation page has every step, including Android 14's wireless debugging and the TCL auto start fix. After this you never need the computer again: Shore updates itself.

What it does

Home Dock, List and Shelf layouts, up to nine apps in your order, recently used apps, your own icons, Continue watching. More
HDMI inputs A console or set-top box gets a tile when it is switched on, named over HDMI-CEC. More
Search Apps, inputs and Settings pages, typed with the remote or on your phone. More
Pictures 15 bundled photos, online and animated wallpapers, your own photos, a different photo for each part of the day. More
Under the clock Weather, headlines, your next calendar event, what is playing, optional widgets. More
Music view The cover, controls and synced lyrics that light up word by word. More
When you're away Shore's own screensaver, night mode and a sleep timer. More
Control Any remote button can do something else. A parental lock and daily screen time limits. More
Phone companion A web app on your phone, served by the TV: photos, settings, apps, keyboard, backups. More
Add-ons Off until you switch them on: Home Assistant, Pi-hole and AdGuard, weather effects, headlines, widgets. More
Performance Auto, High end, Balanced or Potato: Shore keeps what your TV can draw smoothly. More
Languages English, German, French, Spanish, Dutch, Polish, Ukrainian, Italian and Turkish.
Shore Companion on a phone: send photos, my photos and the weather place Framing a photo to the TV's 16:9 shape The companion's TV settings tab The companion's Apps tab
The phone companion: photos, TV settings and apps from your phone, over your home Wi-Fi. Pictures of the real page with invented data.

Verified devices

Most Google TV and Android TV sets should work. These have been run:

Device System Status
TCL 55C6KS Android TV 12 (Google TV) Reference TV: everything is built and checked here
TCL 65C7K Google TV Reported working
CHiQ L32QM8G Android 14 Reported working
Hisense A6N series Android TV 12, 2 GB RAM Reported working, Home Assistant add-on tested

The wiki's Verified devices page has the details, and a TV report adds yours.

Documentation

The wiki has a page for every feature, plus Troubleshooting.

Build from source

git clone https://github.com/taynotfound/shore.git && cd shore
echo "sdk.dir=$HOME/Android/Sdk" > android/local.properties
gradle -p android assembleRelease

Needs JDK 17 and the Android SDK (platform 35). Release APKs carry no API keys, so Unsplash, Pexels and Klipy wallpapers and Top Shelf recommendations need a build with your own. The Build from source page covers keys, GitHub Actions and the browser preview (npm ci && npm run dev:public). Read CONTRIBUTING.md before opening a pull request, and docs/ for developer notes.

Support

Questions, bugs or a TV to report: Discord, usually the fastest way to reach me. Shore is free. If you'd like to support it: Ko-fi · GitHub Sponsors

Credits and licences

MIT. Shore is a fork of CleanFrame by Nathan Clark and keeps its licence and third-party notices. The Home Assistant add-on was made by mozthewah. Photos, logos, fonts, weather, lyrics and recommendations come from other people under their own terms; the full list is on the wiki's Credits and licences page.

About

A personal home screen for Google TV's.

Resources

Contributing

Stars

6 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages