yanhuo-tv

Project Overview

yanhuoTV is an aggregated player redesigned for Android TV and TV boxes, bringing together live CCTV and provincial satellite channels, TVBox video subscriptions, and the ddys (low-end video) waterfall feed. Its interface is rebuilt around remote-control logic and big-screen viewing, so the directional keys move smoothly between sections, grids, and playback. The project only handles the player and interface aggregation and neither stores nor distributes any video resources; live sources and subscription endpoints all come from third-party public APIs.

A big-screen aggregated player you can drive entirely with a remote.

Key Features

• Live TV: 552 built-in CCTV, satellite, and local channels with grouped switching and automatic backup-source merging for duplicate names
• Video aggregation: aggregate movies, series, anime, and variety shows through TVBox subscriptions with multi-site search
• Waterfall feed: connect to the official ddys API for a waterfall layout, categories, search, and line/episode selection
• Remote controls: use up / down to change channels and left / right to adjust volume during playback, with graded back navigation
• Phone debugging: scan a QR code to open a web page on your phone and edit endpoints, domains, and live sources
• Interface details: a splash animation, a custom focus system, and an on-screen TV keyboard
• Auto update: check for and download new versions inside the app

Target Audience

• Users of Android TV or TV boxes
• Viewers who want live TV and on-demand in one place
• Big-screen users accustomed to remote controls
• Developers interested in Compose for TV

Quick Start

1. Install the app on an Android TV or TV box
2. Use the remote's directional keys to move between Live, Video, Feed, and Settings
3. During live playback, use up / down to change channels and left / right to adjust volume
4. Open Settings and scan the QR code with your phone to edit endpoints and live sources
5. Check for updates in Settings and get the newest version

Core Advantages

• Remote-first: a custom focus system keeps the OK and directional keys stable and responsive
• Three sources in one: live TV, subscribed videos, and the waterfall feed share one interface
• Configure by phone: no typing on the TV, since scanning a code opens every setting
• Big-screen feel: the layout is redesigned for TV size and viewing distance

System Requirements

Item	Requirement
OS	Android TV / TV box (Android 7.0 and above)
Build environment	Kotlin, Jetpack Compose, and the Android SDK
Network	Access to third-party live and subscription APIs

Notes

• The project neither stores nor distributes any video resources; all endpoints come from third-party public addresses
• For personal study and research only; not for commercial use
• Built-in live sources may go offline and can be replaced in settings