whatisgithub

What is webtv?

motao123/webtv — explained in plain English

Analysis updated 2026-05-18

32JavaAudience · generalComplexity · 3/5Setup · moderate

In one sentence

An Android and Android TV video player shell that connects to JSON config files you provide, with sync between devices.

Mindmap

mindmap
  root((webtv))
    What it does
      Video player shell
      Loads JSON configs
      Syncs between devices
    Tech stack
      Java
      Android
      Leanback TV
    Use cases
      Bring your own config
      Sync phone to TV
      Custom web home pages
    Audience
      Self hosters

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Load your own JSON configuration file to point the player at on-demand or live video sources.

USE CASE 2

One-tap sync your configuration, watch history, and bookmarks from your phone to your TV.

USE CASE 3

Use a content source's custom WebHome page that can trigger native playback and search.

USE CASE 4

Enable the family filter to hide keyword-matched content from the home page and search.

What is it built with?

JavaAndroidLeanback

How does it compare?

motao123/webtvbell11213442/ruby-clientsfee1212/moyutv
Stars323232
LanguageJavaJavaJava
Setup difficultymoderatemoderatemoderate
Complexity3/52/53/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires bringing your own JSON configuration file, the app ships with no content sources.

Unknown, the explanation does not state a license.

So what is it?

WebHomeTV is an Android app for phones and Android TV devices that acts as a video player shell. It does not come with any built-in streaming content or channel lists. Instead, it provides a well-made player interface that connects to JSON configuration files you bring yourself. Those configuration files point to on-demand video sources, live TV channels, or wallpaper feeds. The app is a fork and continuation of the FongMi and CatVod open-source projects, which are popular in the Chinese-speaking community for building self-hosted media player setups. The main appeal of the app is how it handles configuration management and sync. Before applying a new configuration, it checks whether the file is valid, so a broken import cannot overwrite a working setup. You can browse your configuration history, see which source each one came from, and when it was last used. A one-tap sync feature lets you push your entire app state (configuration sources, watch history, bookmarks, settings) from your phone to a TV or between any two devices on the same local network. The WebHome feature lets individual content sources define their own custom web-based home page, which the app loads inside a browser view alongside the native player controls. Those web pages can call into the app's native functions through a JavaScript interface (accessible as window.fm), allowing them to trigger native video playback, search, cache resources, or read watch history without leaving the app. A family filter lets you block content by keyword so that items unsuitable for a living room display are hidden from the home page, categories, and search results. The app ships separate APK files for Android TV (the Leanback interface with remote control support) and for phones, and for both newer 64-bit and older 32-bit processors. The project explicitly states it does not provide or distribute any content sources. The README is written in Simplified Chinese.

Copy-paste prompts

Prompt 1
Help me install webtv on my Android TV and load a JSON configuration file I already have.
Prompt 2
Explain how webtv's one-tap sync moves configuration and watch history between devices.
Prompt 3
Show me how a WebHome page can call the window.fm JavaScript interface to trigger playback.
Prompt 4
Walk me through setting up the family filter to block certain keywords in webtv.

Frequently asked questions

What is webtv?

An Android and Android TV video player shell that connects to JSON config files you provide, with sync between devices.

What language is webtv written in?

Mainly Java. The stack also includes Java, Android, Leanback.

What license does webtv use?

Unknown, the explanation does not state a license.

How hard is webtv to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is webtv for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.