# xiaomingky/mingyuntime architecture

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

- Interactive diagram: https://gitdiagram.com/xiaomingky/mingyuntime
- Repository: https://github.com/xiaomingky/mingyuntime

## Overview

MingYun Time is a Windows Electron music player with video, esports, and smart-textbook features. Users browse or search a selected music platform, choose tracks, and play or queue them; the app also supports lyrics, local media, downloads, video, esports, and textbook workflows. The graph captures documented capabilities and sampled Electron/API wiring. Several feature implementations are not shown, so their links are documented only where the README supports them; unsampled integrations are omitted.

Main entry points: [`electron/main.js`](https://github.com/xiaomingky/mingyuntime/blob/master/electron/main.js) (Electron main), [`src/views/Search.vue`](https://github.com/xiaomingky/mingyuntime/blob/master/src/views/Search.vue) (Music search), [`electron/bilibili-video.js`](https://github.com/xiaomingky/mingyuntime/blob/master/electron/bilibili-video.js) (Video features), [`src/api/index.js`](https://github.com/xiaomingky/mingyuntime/blob/master/src/api/index.js) (Music API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Desktop client"]
  node_app["App shell<br/>[App.vue]"]
  node_router["Navigation<br/>[index.js]"]
  node_electron["Electron main<br/>[main.js]"]
end

subgraph group_music["Music experience"]
  node_search["Music search<br/>[Search.vue]"]
  node_suggest["Search suggestions<br/>[SearchSuggest.vue]"]
  node_player["Playback queue<br/>[player.js]"]
  node_lyrics["Lyrics<br/>[lyric-providers.js]"]
end

subgraph group_media["Media and downloads"]
  node_download["Download manager"]
  node_video["Video features<br/>[bilibili-video.js]"]
  node_anime["Anime features<br/>[anime.js]"]
  node_movies["Movie features<br/>[movie.js]"]
  node_local["Local media<br/>[local-service.js]"]
end

subgraph group_services["Platform services"]
  node_platformapi["Music API client<br/>[index.js]"]
  node_kugou["KuGou API service<br/>[server.js]"]
  node_netease["NetEase API service<br/>[server.js]"]
end

subgraph group_extras["Other features"]
  node_esports["Esports<br/>[esports-service.js]"]
  node_textbook["Smart textbook<br/>[smart-edu.js]"]
end

node_user(("Listener"))
node_music_platforms(("Music platforms"))
node_media_sources(("Video sources"))

node_user -->|"uses"| node_app
node_app -->|"renders routes"| node_router
node_router -->|"routes to"| node_search
node_user -->|"searches"| node_search
node_search -->|"requests results"| node_platformapi
node_suggest -->|"requests suggestions"| node_platformapi
node_user -->|"plays or queues"| node_player
node_user -->|"selects lyrics"| node_lyrics
node_electron -->|"calls providers"| node_lyrics
node_platformapi -->|"fetches music data"| node_music_platforms
node_user -->|"manages local media"| node_local
node_user -->|"browses and plays"| node_video
node_video -->|"resolves content"| node_media_sources
node_user -->|"browses episodes"| node_anime
node_user -->|"browses and plays"| node_movies
node_user -->|"downloads media"| node_download
node_electron -->|"delegates downloads"| node_download
node_user -->|"views competitions"| node_esports
node_user -->|"reads and annotates"| node_textbook
node_electron -->|"registers feature"| node_video
node_electron -->|"registers feature"| node_anime
node_electron -->|"registers feature"| node_movies
node_electron -->|"registers service"| node_esports
node_electron -->|"registers service"| node_textbook
node_music_platforms -.->|"serves KuGou API"| node_kugou
node_music_platforms -.->|"serves NetEase API"| node_netease

click node_app "https://github.com/xiaomingky/mingyuntime/blob/master/src/App.vue"
click node_router "https://github.com/xiaomingky/mingyuntime/blob/master/src/router/index.js"
click node_search "https://github.com/xiaomingky/mingyuntime/blob/master/src/views/Search.vue"
click node_suggest "https://github.com/xiaomingky/mingyuntime/blob/master/src/components/SearchSuggest.vue"
click node_player "https://github.com/xiaomingky/mingyuntime/blob/master/src/store/player.js"
click node_lyrics "https://github.com/xiaomingky/mingyuntime/blob/master/electron/lyric-providers.js"
click node_platformapi "https://github.com/xiaomingky/mingyuntime/blob/master/src/api/index.js"
click node_electron "https://github.com/xiaomingky/mingyuntime/blob/master/electron/main.js"
click node_kugou "https://github.com/xiaomingky/mingyuntime/blob/master/resources/kugou-music-api-src/server.js"
click node_netease "https://github.com/xiaomingky/mingyuntime/blob/master/resources/netease-api-src/server.js"
click node_download "https://github.com/xiaomingky/mingyuntime/blob/master/electron/download-manager.js"
click node_video "https://github.com/xiaomingky/mingyuntime/blob/master/electron/bilibili-video.js"
click node_anime "https://github.com/xiaomingky/mingyuntime/blob/master/electron/anime.js"
click node_movies "https://github.com/xiaomingky/mingyuntime/blob/master/electron/movie.js"
click node_local "https://github.com/xiaomingky/mingyuntime/blob/master/electron/local-service.js"
click node_esports "https://github.com/xiaomingky/mingyuntime/blob/master/electron/esports-service.js"
click node_textbook "https://github.com/xiaomingky/mingyuntime/blob/master/electron/smart-edu.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_router,node_electron toneBlue
class node_search,node_suggest,node_player,node_lyrics toneAmber
class node_download,node_video,node_anime,node_movies,node_local toneMint
class node_platformapi,node_kugou,node_netease toneRose
class node_esports,node_textbook,node_user,node_music_platforms,node_media_sources toneIndigo
```

## Components

### Desktop client

- [App shell](https://github.com/xiaomingky/mingyuntime/blob/master/src/App.vue): `src/App.vue`
- [Navigation](https://github.com/xiaomingky/mingyuntime/blob/master/src/router/index.js): `src/router/index.js`
- [Electron main](https://github.com/xiaomingky/mingyuntime/blob/master/electron/main.js): `electron/main.js`

### Music experience

- [Music search](https://github.com/xiaomingky/mingyuntime/blob/master/src/views/Search.vue): `src/views/Search.vue`
- [Search suggestions](https://github.com/xiaomingky/mingyuntime/blob/master/src/components/SearchSuggest.vue): `src/components/SearchSuggest.vue`
- [Playback queue](https://github.com/xiaomingky/mingyuntime/blob/master/src/store/player.js): `src/store/player.js`
- [Lyrics](https://github.com/xiaomingky/mingyuntime/blob/master/electron/lyric-providers.js): `electron/lyric-providers.js`

### Media and downloads

- [Download manager](https://github.com/xiaomingky/mingyuntime/blob/master/electron/download-manager.js): `electron/download-manager.js`
- [Video features](https://github.com/xiaomingky/mingyuntime/blob/master/electron/bilibili-video.js): `electron/bilibili-video.js`
- [Anime features](https://github.com/xiaomingky/mingyuntime/blob/master/electron/anime.js): `electron/anime.js`
- [Movie features](https://github.com/xiaomingky/mingyuntime/blob/master/electron/movie.js): `electron/movie.js`
- [Local media](https://github.com/xiaomingky/mingyuntime/blob/master/electron/local-service.js): `electron/local-service.js`

### Platform services

- [Music API client](https://github.com/xiaomingky/mingyuntime/blob/master/src/api/index.js): `src/api/index.js`
- [KuGou API service](https://github.com/xiaomingky/mingyuntime/blob/master/resources/kugou-music-api-src/server.js): `resources/kugou-music-api-src/server.js`
- [NetEase API service](https://github.com/xiaomingky/mingyuntime/blob/master/resources/netease-api-src/server.js): `resources/netease-api-src/server.js`

### Other features

- [Esports](https://github.com/xiaomingky/mingyuntime/blob/master/electron/esports-service.js): `electron/esports-service.js`
- [Smart textbook](https://github.com/xiaomingky/mingyuntime/blob/master/electron/smart-edu.js): `electron/smart-edu.js`

### Other components

- **Listener**
- **Music platforms**
- **Video sources**

## Connections

- Listener → App shell: uses (evidence: `README.md`)
- App shell → Navigation: renders routes (evidence: `src/App.vue`)
- Navigation → Music search: routes to (evidence: `src/router/index.js`)
- Listener → Music search: searches (evidence: `README.md`)
- Music search → Music API client: requests results (evidence: `src/views/Search.vue`)
- Search suggestions → Music API client: requests suggestions (evidence: `src/components/SearchSuggest.vue`)
- Listener → Playback queue: plays or queues (evidence: `README.md`)
- Listener → Lyrics: selects lyrics (evidence: `README.md`)
- Electron main → Lyrics: calls providers (evidence: `electron/main.js`)
- Music API client → Music platforms: fetches music data (evidence: `src/api/index.js`)
- Listener → Local media: manages local media (evidence: `README.md`)
- Listener → Video features: browses and plays (evidence: `README.md`)
- Video features → Video sources: resolves content (evidence: `README.md`)
- Listener → Anime features: browses episodes (evidence: `README.md`)
- Listener → Movie features: browses and plays (evidence: `README.md`)
- Listener → Download manager: downloads media (evidence: `README.md`)
- Electron main → Download manager: delegates downloads (evidence: `electron/main.js`)
- Listener → Esports: views competitions (evidence: `README.md`)
- Listener → Smart textbook: reads and annotates (evidence: `README.md`)
- Electron main → Video features: registers feature (evidence: `electron/main.js`)
- Electron main → Anime features: registers feature (evidence: `electron/main.js`)
- Electron main → Movie features: registers feature (evidence: `electron/main.js`)
- Electron main → Esports: registers service (evidence: `electron/main.js`)
- Electron main → Smart textbook: registers service (evidence: `electron/main.js`)
- Music platforms → KuGou API service: serves KuGou API (evidence: `README.md`)
- Music platforms → NetEase API service: serves NetEase API (evidence: `README.md`)
