# hunlongyu/zy-player architecture

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

- Interactive diagram: https://gitdiagram.com/hunlongyu/zy-player
- Repository: https://github.com/hunlongyu/zy-player

## Overview

ZY Player is a desktop resource and IPTV media player. The main workflow is browsing or searching configured video sources, opening a title, resolving its stream, and playing it while saving viewing progress. The interface also supports live channels, recommendations, favorites, history, source management, sharing, and configurable playback. Edges use only relationships visible in the supplied excerpts or README; other documented features remain represented where their implementation path is supported by the tree.

Main entry points: [`src/App.vue`](https://github.com/hunlongyu/zy-player/blob/master/src/App.vue) (App Shell), [`src/components/Play.vue`](https://github.com/hunlongyu/zy-player/blob/master/src/components/Play.vue) (Video Player), [`src/lib/dexie/index.js`](https://github.com/hunlongyu/zy-player/blob/master/src/lib/dexie/index.js) (Data Accessors), [`src/components/Setting.vue`](https://github.com/hunlongyu/zy-player/blob/master/src/components/Setting.vue) (Settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Application UI"]
  node_app["App Shell<br/>[App.vue]"]
  node_navigation["Navigation<br/>[Aside.vue]"]
  node_window_frame["Window Frame<br/>[Frame.vue]"]
  node_settings_ui["Settings<br/>[Setting.vue]"]
end

subgraph group_media["Discovery and Playback"]
  node_browse["Film Browser<br/>[Film.vue]"]
  node_detail["Title Details<br/>[Detail.vue]"]
  node_play["Video Player<br/>[Play.vue]"]
  node_iptv["IPTV Channels<br/>[IPTV.vue]"]
  node_recommendations["Recommendations<br/>[Recommendation.vue]"]
  node_history_ui["Playback History<br/>[History.vue]"]
  node_favorites["Favorites<br/>[Star.vue]"]
  node_source_editor["Source Manager<br/>[EditSites.vue]"]
  node_sharing["Share and Export<br/>[Share.vue]"]
  node_source_api["Source API Client<br/>[tools.js]"]
  node_online_video["Online Video Resolver<br/>[onlineVideo.js]"]
end

subgraph group_data["Local Data"]
  node_database[("IndexedDB<br/>[dexie.js]")]
  node_initial_data["Default Data<br/>[initData.js]"]
  node_data_access["Data Accessors<br/>[index.js]"]
end

subgraph group_desktop["Desktop Integration"]
  node_background["Electron Background<br/>[background.js]"]
  node_updater["Update Service<br/>[update.js]"]
end

node_viewer(("Viewer"))
node_external_player["External Player"]
node_media_sources["Video Sources"]

node_viewer -->|"uses"| node_app
node_app -->|"renders"| node_navigation
node_app -->|"renders"| node_window_frame
node_app -->|"renders"| node_browse
node_app -->|"renders"| node_play
node_app -->|"renders"| node_favorites
node_app -->|"renders"| node_history_ui
node_app -->|"renders"| node_settings_ui
node_app -->|"renders"| node_iptv
node_app -->|"renders"| node_source_editor
node_app -->|"renders"| node_detail
node_app -->|"renders"| node_sharing
node_viewer -->|"browses"| node_browse
node_browse -->|"requests titles"| node_source_api
node_source_api -->|"fetches metadata"| node_media_sources
node_browse -.->|"opens title"| node_detail
node_detail -->|"loads details"| node_source_api
node_source_api -->|"resolves streams"| node_media_sources
node_detail -->|"uses resolver"| node_online_video
node_viewer -->|"manages channels"| node_iptv
node_iptv -.->|"starts playback"| node_play
node_viewer -->|"browses picks"| node_recommendations
node_viewer -->|"resumes viewing"| node_history_ui
node_viewer -->|"manages favorites"| node_favorites
node_viewer -->|"manages sources"| node_source_editor
node_viewer -->|"shares resources"| node_sharing
node_viewer -->|"configures player"| node_settings_ui
node_play -->|"reads history"| node_database
node_play -->|"saves progress"| node_database
node_play -->|"launches"| node_external_player
node_source_editor -->|"accesses sources"| node_data_access
node_iptv -->|"accesses channel data"| node_data_access
node_settings_ui -->|"accesses settings"| node_data_access
node_app -->|"loads settings"| node_data_access
node_data_access -->|"wraps stores"| node_database
node_database -->|"populates defaults"| node_initial_data
node_background -->|"delegates updates"| node_updater
node_settings_ui -->|"requests update"| node_background

click node_app "https://github.com/hunlongyu/zy-player/blob/master/src/App.vue"
click node_navigation "https://github.com/hunlongyu/zy-player/blob/master/src/components/Aside.vue"
click node_window_frame "https://github.com/hunlongyu/zy-player/blob/master/src/components/Frame.vue"
click node_browse "https://github.com/hunlongyu/zy-player/blob/master/src/components/Film.vue"
click node_detail "https://github.com/hunlongyu/zy-player/blob/master/src/components/Detail.vue"
click node_play "https://github.com/hunlongyu/zy-player/blob/master/src/components/Play.vue"
click node_iptv "https://github.com/hunlongyu/zy-player/blob/master/src/components/IPTV.vue"
click node_recommendations "https://github.com/hunlongyu/zy-player/blob/master/src/components/Recommendation.vue"
click node_history_ui "https://github.com/hunlongyu/zy-player/blob/master/src/components/History.vue"
click node_favorites "https://github.com/hunlongyu/zy-player/blob/master/src/components/Star.vue"
click node_source_editor "https://github.com/hunlongyu/zy-player/blob/master/src/components/EditSites.vue"
click node_sharing "https://github.com/hunlongyu/zy-player/blob/master/src/components/Share.vue"
click node_settings_ui "https://github.com/hunlongyu/zy-player/blob/master/src/components/Setting.vue"
click node_source_api "https://github.com/hunlongyu/zy-player/blob/master/src/lib/site/tools.js"
click node_online_video "https://github.com/hunlongyu/zy-player/blob/master/src/lib/site/onlineVideo.js"
click node_database "https://github.com/hunlongyu/zy-player/blob/master/src/lib/dexie/dexie.js"
click node_initial_data "https://github.com/hunlongyu/zy-player/blob/master/src/lib/dexie/initData.js"
click node_data_access "https://github.com/hunlongyu/zy-player/blob/master/src/lib/dexie/index.js"
click node_background "https://github.com/hunlongyu/zy-player/blob/master/src/background.js"
click node_updater "https://github.com/hunlongyu/zy-player/blob/master/src/lib/update/update.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_app,node_navigation,node_window_frame,node_settings_ui,node_viewer toneBlue
class node_browse,node_detail,node_play,node_iptv,node_recommendations,node_history_ui,node_favorites,node_source_editor,node_sharing,node_source_api,node_online_video toneAmber
class node_database,node_initial_data,node_data_access toneMint
class node_background,node_updater toneRose
class node_external_player,node_media_sources toneIndigo
```

## Components

### Application UI

- [App Shell](https://github.com/hunlongyu/zy-player/blob/master/src/App.vue): `src/App.vue`
- [Navigation](https://github.com/hunlongyu/zy-player/blob/master/src/components/Aside.vue): `src/components/Aside.vue`
- [Window Frame](https://github.com/hunlongyu/zy-player/blob/master/src/components/Frame.vue): `src/components/Frame.vue`
- [Settings](https://github.com/hunlongyu/zy-player/blob/master/src/components/Setting.vue): `src/components/Setting.vue`

### Discovery and Playback

- [Film Browser](https://github.com/hunlongyu/zy-player/blob/master/src/components/Film.vue): `src/components/Film.vue`
- [Title Details](https://github.com/hunlongyu/zy-player/blob/master/src/components/Detail.vue): `src/components/Detail.vue`
- [Video Player](https://github.com/hunlongyu/zy-player/blob/master/src/components/Play.vue): `src/components/Play.vue`
- [IPTV Channels](https://github.com/hunlongyu/zy-player/blob/master/src/components/IPTV.vue): `src/components/IPTV.vue`
- [Recommendations](https://github.com/hunlongyu/zy-player/blob/master/src/components/Recommendation.vue): `src/components/Recommendation.vue`
- [Playback History](https://github.com/hunlongyu/zy-player/blob/master/src/components/History.vue): `src/components/History.vue`
- [Favorites](https://github.com/hunlongyu/zy-player/blob/master/src/components/Star.vue): `src/components/Star.vue`
- [Source Manager](https://github.com/hunlongyu/zy-player/blob/master/src/components/EditSites.vue): `src/components/EditSites.vue`
- [Share and Export](https://github.com/hunlongyu/zy-player/blob/master/src/components/Share.vue): `src/components/Share.vue`
- [Source API Client](https://github.com/hunlongyu/zy-player/blob/master/src/lib/site/tools.js): `src/lib/site/tools.js`
- [Online Video Resolver](https://github.com/hunlongyu/zy-player/blob/master/src/lib/site/onlineVideo.js): `src/lib/site/onlineVideo.js`

### Local Data

- [IndexedDB](https://github.com/hunlongyu/zy-player/blob/master/src/lib/dexie/dexie.js): `src/lib/dexie/dexie.js`
- [Default Data](https://github.com/hunlongyu/zy-player/blob/master/src/lib/dexie/initData.js): `src/lib/dexie/initData.js`
- [Data Accessors](https://github.com/hunlongyu/zy-player/blob/master/src/lib/dexie/index.js): `src/lib/dexie/index.js`

### Desktop Integration

- [Electron Background](https://github.com/hunlongyu/zy-player/blob/master/src/background.js): `src/background.js`
- [Update Service](https://github.com/hunlongyu/zy-player/blob/master/src/lib/update/update.js): `src/lib/update/update.js`

### Other components

- **Viewer**
- **External Player**
- **Video Sources**

## Connections

- Viewer → App Shell: uses (evidence: `README.md`)
- App Shell → Navigation: renders (evidence: `src/App.vue`)
- App Shell → Window Frame: renders (evidence: `src/App.vue`)
- App Shell → Film Browser: renders (evidence: `src/App.vue`)
- App Shell → Video Player: renders (evidence: `src/App.vue`)
- App Shell → Favorites: renders (evidence: `src/App.vue`)
- App Shell → Playback History: renders (evidence: `src/App.vue`)
- App Shell → Settings: renders (evidence: `src/App.vue`)
- App Shell → IPTV Channels: renders (evidence: `src/App.vue`)
- App Shell → Source Manager: renders (evidence: `src/App.vue`)
- App Shell → Title Details: renders (evidence: `src/App.vue`)
- App Shell → Share and Export: renders (evidence: `src/App.vue`)
- Viewer → Film Browser: browses (evidence: `README.md`)
- Film Browser → Source API Client: requests titles (evidence: `src/components/Film.vue`)
- Source API Client → Video Sources: fetches metadata (evidence: `src/lib/site/tools.js`)
- Film Browser → Title Details: opens title
- Title Details → Source API Client: loads details (evidence: `src/components/Detail.vue`)
- Source API Client → Video Sources: resolves streams (evidence: `src/lib/site/tools.js`)
- Title Details → Online Video Resolver: uses resolver (evidence: `src/components/Detail.vue`)
- Viewer → IPTV Channels: manages channels (evidence: `README.md`)
- IPTV Channels → Video Player: starts playback
- Viewer → Recommendations: browses picks (evidence: `README.md`)
- Viewer → Playback History: resumes viewing (evidence: `README.md`)
- Viewer → Favorites: manages favorites (evidence: `README.md`)
- Viewer → Source Manager: manages sources (evidence: `README.md`)
- Viewer → Share and Export: shares resources (evidence: `README.md`)
- Viewer → Settings: configures player (evidence: `README.md`)
- Video Player → IndexedDB: reads history (evidence: `src/components/Play.vue`)
- Video Player → IndexedDB: saves progress (evidence: `src/components/Play.vue`)
- Video Player → External Player: launches (evidence: `src/components/Play.vue`)
- Source Manager → Data Accessors: accesses sources (evidence: `src/components/EditSites.vue`)
- IPTV Channels → Data Accessors: accesses channel data (evidence: `src/components/IPTV.vue`)
- Settings → Data Accessors: accesses settings (evidence: `src/components/Setting.vue`)
- App Shell → Data Accessors: loads settings (evidence: `src/App.vue`)
- Data Accessors → IndexedDB: wraps stores (evidence: `src/lib/dexie/index.js`)
- IndexedDB → Default Data: populates defaults (evidence: `src/lib/dexie/dexie.js`)
- Electron Background → Update Service: delegates updates (evidence: `src/background.js`)
- Settings → Electron Background: requests update (evidence: `src/components/Setting.vue`)
