# youhunwl/tvapp architecture

> Architecture diagram of the GitHub repository youhunwl/tvapp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/youhunwl/tvapp
- Repository: https://github.com/youhunwl/tvapp

## Overview

TVAPP is a curated repository of Android TV and mobile app packages, not a single application with a shared runtime. The principal workflow is to browse the catalog, choose a package, install it on a compatible device, and—where required—configure content or live-stream sources. The README also documents a Ku9 WebView control script. The packages themselves are binaries, so their internal workflows and interactions cannot be mapped from this repository; links below reflect documented catalog relationships only.

Main entry points: [`README.md`](https://github.com/youhunwl/tvapp/blob/main/README.md) (App catalog), [`TVBox`](https://github.com/youhunwl/tvapp/tree/main/TVBox) (TVBox packages), [`电视直播`](https://github.com/youhunwl/tvapp/tree/main/%E7%94%B5%E8%A7%86%E7%9B%B4%E6%92%AD) (Live TV apps), [`影视`](https://github.com/youhunwl/tvapp/tree/main/%E5%BD%B1%E8%A7%86) (Movie apps)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Catalog"]
  node_readme["App catalog<br/>[README.md]"]
end

subgraph group_media["Media Apps"]
  node_tvbox["TVBox packages"]
  node_movies["Movie apps"]
  node_live["Live TV apps"]
end

subgraph group_other["Other Apps"]
  node_karaoke["Karaoke apps"]
  node_entertainment["Entertainment apps"]
  node_utilities["Utility apps"]
  node_education["Learning apps"]
  node_fitness["Fitness apps"]
end

subgraph group_webview["WebView Controls"]
  node_ku9controls["WebView controls<br/>[webview_jscode.js]"]
end

node_user(("App seeker"))
node_device(("Android device"))
node_content_sources(("Content sources"))

node_user -->|"browses"| node_readme
node_readme -->|"lists packages"| node_tvbox
node_readme -->|"lists packages"| node_movies
node_readme -->|"lists packages"| node_live
node_readme -->|"lists packages"| node_karaoke
node_readme -->|"collects apps"| node_entertainment
node_readme -->|"collects apps"| node_utilities
node_readme -->|"collects apps"| node_education
node_readme -->|"collects apps"| node_fitness
node_user -->|"installs package"| node_device
node_tvbox -->|"requires configuration"| node_content_sources
node_live -->|"uses stream sources"| node_content_sources

click node_readme "https://github.com/youhunwl/tvapp/blob/main/README.md"
click node_tvbox "https://github.com/youhunwl/tvapp/tree/main/TVBox"
click node_movies "https://github.com/youhunwl/tvapp/tree/main/%E5%BD%B1%E8%A7%86"
click node_live "https://github.com/youhunwl/tvapp/tree/main/%E7%94%B5%E8%A7%86%E7%9B%B4%E6%92%AD"
click node_karaoke "https://github.com/youhunwl/tvapp/tree/main/K%E6%AD%8C"
click node_entertainment "https://github.com/youhunwl/tvapp/tree/main/%E5%A8%B1%E4%B9%90%E5%BA%94%E7%94%A8"
click node_utilities "https://github.com/youhunwl/tvapp/tree/main/%E5%AE%9E%E7%94%A8%E5%B7%A5%E5%85%B7"
click node_education "https://github.com/youhunwl/tvapp/tree/main/%E6%95%99%E8%82%B2%E5%AD%A6%E4%B9%A0"
click node_fitness "https://github.com/youhunwl/tvapp/tree/main/%E8%BF%90%E5%8A%A8%E5%81%A5%E8%BA%AB"
click node_ku9controls "https://github.com/youhunwl/tvapp/blob/main/%E7%94%B5%E8%A7%86%E7%9B%B4%E6%92%AD/%E9%85%B79%E7%9B%B4%E6%92%AD/webview%E5%8F%8C%E6%A8%A1%E5%BC%8F%E6%92%AD%E6%94%BE%E5%85%A8%E6%94%BB%E7%95%A5/webview_jscode.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_readme toneBlue
class node_tvbox,node_movies,node_live toneAmber
class node_karaoke,node_entertainment,node_utilities,node_education,node_fitness toneMint
class node_ku9controls toneRose
class node_user,node_device,node_content_sources toneIndigo
```

## Components

### Catalog

- [App catalog](https://github.com/youhunwl/tvapp/blob/main/README.md): `README.md`

### Media Apps

- [TVBox packages](https://github.com/youhunwl/tvapp/tree/main/TVBox): `TVBox`
- [Movie apps](https://github.com/youhunwl/tvapp/tree/main/%E5%BD%B1%E8%A7%86): `影视`
- [Live TV apps](https://github.com/youhunwl/tvapp/tree/main/%E7%94%B5%E8%A7%86%E7%9B%B4%E6%92%AD): `电视直播`

### Other Apps

- [Karaoke apps](https://github.com/youhunwl/tvapp/tree/main/K%E6%AD%8C): `K歌`
- [Entertainment apps](https://github.com/youhunwl/tvapp/tree/main/%E5%A8%B1%E4%B9%90%E5%BA%94%E7%94%A8): `娱乐应用`
- [Utility apps](https://github.com/youhunwl/tvapp/tree/main/%E5%AE%9E%E7%94%A8%E5%B7%A5%E5%85%B7): `实用工具`
- [Learning apps](https://github.com/youhunwl/tvapp/tree/main/%E6%95%99%E8%82%B2%E5%AD%A6%E4%B9%A0): `教育学习`
- [Fitness apps](https://github.com/youhunwl/tvapp/tree/main/%E8%BF%90%E5%8A%A8%E5%81%A5%E8%BA%AB): `运动健身`

### WebView Controls

- [WebView controls](https://github.com/youhunwl/tvapp/blob/main/%E7%94%B5%E8%A7%86%E7%9B%B4%E6%92%AD/%E9%85%B79%E7%9B%B4%E6%92%AD/webview%E5%8F%8C%E6%A8%A1%E5%BC%8F%E6%92%AD%E6%94%BE%E5%85%A8%E6%94%BB%E7%95%A5/webview_jscode.js): `电视直播/酷9直播/webview双模式播放全攻略/webview_jscode.js`

### Other components

- **App seeker**
- **Android device**
- **Content sources**

## Connections

- App seeker → App catalog: browses (evidence: `README.md`)
- App catalog → TVBox packages: lists packages (evidence: `README.md`)
- App catalog → Movie apps: lists packages (evidence: `README.md`)
- App catalog → Live TV apps: lists packages (evidence: `README.md`)
- App catalog → Karaoke apps: lists packages (evidence: `README.md`)
- App catalog → Entertainment apps: collects apps (evidence: `README.md`)
- App catalog → Utility apps: collects apps (evidence: `README.md`)
- App catalog → Learning apps: collects apps (evidence: `README.md`)
- App catalog → Fitness apps: collects apps (evidence: `README.md`)
- App seeker → Android device: installs package (evidence: `README.md`)
- TVBox packages → Content sources: requires configuration (evidence: `README.md`)
- Live TV apps → Content sources: uses stream sources (evidence: `README.md`)