Note
Not an official Silo project. "Silo" is a trademark of Silo Media L.L.C.; this app is an independent client for Silo. silo-tv is a working title: the app gets a name of its own before the first store release.
It works with any Silo server (API v2): you enter the server's address on the TV, nothing is built in.
| Area | What you get |
|---|---|
| Sign-in from the couch | a code or QR code you confirm on your phone, or a password with the on-screen keyboard; several servers, each with its own sign-in |
| Profiles | a picker with avatars, PIN-protected and kids profiles, creating a profile, and how the app picks the profile at launch |
| Home | the rows your server's home page is built from (Continue Watching, Next Up, Recently Added and the rest), with a hero |
| Movies and Series | recommended rows, collections, and a browse grid with sort, filters (genre, decade, content rating, watch state) and a letter rail |
| Detail pages | laid out like Silo's web app: title art, ratings, quality badges, season and episode pages of their own, cast and crew, similar titles, box sets, and person pages with filmography; mark watched, favourite, rate and add to the watchlist; pick the version, audio and subtitles before playing |
| Search | results while you type: box sets, people, movies, series and episodes; the keyboard has ä, ö, ü and ß |
| Playback | Silo's playback protocol v3: direct play, and HLS remux and transcode through hls.js; resume and start over, with an optional rewind on resume |
| The player | the layout of Silo's web player: a scrubber with buffer, trickplay previews, chapters and coloured intro, recap and credits; skips by your profile's steps; skip intro, recap and credits; previous and next episode; audio and subtitle menus that remember your pick per series or movie, with a subtitle delay; a quality menu that respects your bitrate limit; an Info panel; subtitles in your profile's appearance, set in the web app's dialog with a live preview |
| Up Next | a card at the credits that starts the next episode when your profile's auto-play is on, and an end screen with the episode still playing in a mini player, the next episode and what you are watching elsewhere |
| Extras | Trailers & More (YouTube trailers open in the TV's YouTube app), theme music, spoiler protection for unwatched episodes, AI translation of descriptions, each when your profile and server turn it on |
| Made for the remote | arrows, OK and Back everywhere, the Magic Remote pointer and wheel, and focus that comes back to where you were |
| Your server's look | its name, logo, sign-in background and accent colour |
| German and English | following the TV's language, or chosen in the app's settings |
| Careful with your sign-in | the access token stays in memory, only the refresh token is stored on the TV, and HLS and subtitles send it in a header instead of the URL |
![]() |
![]() |
| Detail page: title art, ratings, seasons | Episodes and Trailers & More |
![]() |
![]() |
| Search with an on-screen keyboard for the remote | Browse with sort, filters and a letter rail |
Taken at 1920×1080 against a test server. Posters, stills and logos belong to their rights holders and are not covered by this project's license.
This card updates itself after every CI run on main and every weekly mutation run:
- CI runs the full gate on every push: types, lint, unit and component tests, the webOS bundle check, end-to-end tests in a browser driven like a remote, and packaging. → CI runs
- Mutation testing changes the code in thousands of small ways and counts how many of these changes the tests catch. A run below the 77 % baseline fails. → Mutation report
- On a real TV: every phase ends with a test of its flows, with direct play and HLS.
What each check does, and how to run it yourself: Tests and quality checks.
Early development; there is no release yet. The goal is a listing in the LG Content Store.
| Phase | Scope | State |
|---|---|---|
| 0 · Feasibility | build for webOS, CORS, API client, code sign-in, a first playback | ✅ on the TV (webOS 24 and 26); webOS 6 itself not yet tested on hardware |
| 1 · Foundation | servers, sign-in, profiles, app shell, TV navigation | 🟨 on the TV (all flows, 2026-11-11); loading, empty and error states still to finish |
| 2 · Browse | home, libraries, detail pages, search, person pages, extras | 🟨 mostly on the TV; the detail pages after Silo's web app and the featured hero are built and partly checked there; AI translation still to check |
| 3 · Player | playback, the overlay after Silo's web player, skips, quality, audio and subtitles, Up Next and the end screen | 🟨 released in v0.4.0; on the TV (2026-11-13): direct play with seeking, HLS, auto-play and the end screen; HDR titles still to check |
| 4 · Personal | For You, calendar, watchlist, requests, profile settings, shuffle, subtitle search | ⬜ planned |
| 5 · Extras | Watch Party, notifications, music and audiobooks | ⬜ planned |
| 6 · Samsung Tizen | the same app for Samsung TVs | ⬜ after the LG release |
Every feature and its state: roadmap.
It is not in the LG Content Store yet. You can install it on an LG TV from 2021 or later (webOS 6 and newer) in Developer Mode, from the file of a release, with a desktop program and no command line. You need a Silo server.
→ Install silo-tv on your LG TV, step by step
- It talks only to Silo's native
/api/v2, through a client generated from Silo's OpenAPI specification. - It is written from scratch against Silo's documentation. No code is taken from Silo's repositories.
- It is built for the TV's old browser engine: React and TypeScript, compiled for Chromium 79 (webOS 6) into one classic script.
- Direct play uses the TV's own video element; HLS plays through hls.js.
- Everything webOS-specific sits behind one platform adapter, so a Samsung Tizen port adds an adapter instead of touching the app.
- It is written with heavy AI assistance (Claude Code): one session plans and reviews, a subagent implements each package, and every change passes the full gate.
| Area | Choice |
|---|---|
| UI | React, Vite, TanStack Query, Norigin spatial navigation for the remote |
| Playback | <video> and hls.js over Media Source Extensions; Silo playback protocol v3 |
| Tests | Vitest, React Testing Library, MSW, Playwright, StrykerJS |
| TV tooling | @webos-tools/cli |
| Document | What is in it |
|---|---|
| Install on your TV | Developer Mode and installing a release without a command line, keeping it running, updates |
| Development and deployment | setup, commands, running in the browser, installing from source, diagnostics, tests and CI |
| Roadmap | every feature by phase, with its state |
| Design | colours, type, layout and focus rules |
| Changelog | generated from the commit history |
CLAUDE.md |
the house rules for every change |
| Tools | the gate, CI and mutation tooling |
Issues, ideas and pull requests are welcome. Reports from webOS versions other than the test TV's are especially useful. How to report and how to contribute: CONTRIBUTING.md. Security problems go to a private report, never into a public issue. Everyone follows the code of conduct; what the app does for accessibility is in ACCESSIBILITY.md.
Mozilla Public License 2.0 (MPL-2.0). Anyone may use, change and share the app, also through app stores. Whoever shares a modified version must publish the source code of the files they changed under the same license; files of their own may carry another license.
This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.




