# lqtmcstudio/qzmusic_pc architecture

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

- Interactive diagram: https://gitdiagram.com/lqtmcstudio/qzmusic_pc
- Repository: https://github.com/lqtmcstudio/qzmusic_pc

## Overview

QZ Music is an Electron desktop music player. Users discover or select music, manage playlists, and control playback; the renderer’s player state coordinates lyrics and listening-together behavior, while the Electron main process brokers plugin, account, settings, and native-player operations. The README identifies QZPlayer as the WASAPI/FFmpeg audio core and AMLL as background rendering. Renderer-to-main IPC wiring and several unsampled feature implementations are represented only where documented or explicitly marked unverified.

Main entry points: [`src/renderer/src/stores/player.ts`](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/stores/player.ts) (Player state), [`src/main/index.ts`](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/index.ts) (Electron IPC), [`src/renderer/src/App.vue`](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/App.vue) (App shell), [`src/renderer/src/main.ts`](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/main.ts) (Music views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_renderer["Desktop experience"]
  node_app["App shell<br/>[App.vue]"]
  node_routes["Music views<br/>[main.ts]"]
  node_search["Search<br/>[Search.vue]"]
  node_playlistview["Playlist view<br/>[Playlist.vue]"]
  node_playerui["Playback controls<br/>[PlayerBar.vue]"]
  node_queueui["Queue controls"]
  node_authui["Account state<br/>[auth.ts]"]
  node_together["Listen together<br/>[listenTogether.ts]"]
end

subgraph group_playback["Playback and media"]
  node_song["Song model<br/>[song.ts]"]
  node_playlists["Playlist state<br/>[playlists.ts]"]
  node_player["Player state<br/>[player.ts]"]
  node_lyrics["Lyric parsing<br/>[lyricUtil.ts]"]
end

subgraph group_services["Main-process services"]
  node_localmusic["Local music<br/>[localMusicStore.ts]"]
  node_auth["Authentication<br/>[authStore.ts]"]
  node_plugin["Plugin runtime<br/>[pluginSystem.ts]"]
  node_proxy["Media proxy<br/>[proxyServer.ts]"]
  node_settings["Settings<br/>[settingsStore.ts]"]
  node_main["Electron IPC<br/>[index.ts]"]
  node_qzp["QZPlayer bridge<br/>[qzpController.ts]"]
  node_audio["Audio engine"]
end

subgraph group_amll["AMLL rendering"]
  node_background["Background render"]
  node_lyricrender["Lyric player"]
  node_amllapi["AMLL interfaces<br/>[interfaces.ts]"]
end

node_user(("Listener"))

node_user -->|"uses"| node_app
node_app -->|"hosts"| node_routes
node_routes -->|"routes to"| node_search
node_routes -->|"routes to"| node_playlistview
node_search -->|"selects songs"| node_player
node_playlistview -->|"queues songs"| node_player
node_playlistview -->|"uses"| node_playlists
node_playlists -->|"stores"| node_song
node_player -->|"manages"| node_song
node_playerui -->|"controls"| node_player
node_queueui -->|"controls queue"| node_player
node_player -->|"parses lyrics"| node_lyrics
node_player -->|"syncs playback"| node_together
node_app -->|"initializes"| node_authui
node_authui -.->|"requests account state"| node_auth
node_search -.->|"searches via"| node_plugin
node_player -->|"fetches lyrics"| node_plugin
node_main -->|"registers service"| node_plugin
node_main -->|"starts proxy"| node_proxy
node_main -->|"loads settings"| node_settings
node_main -->|"handles auth"| node_auth
node_main -->|"starts player bridge"| node_qzp
node_qzp -->|"commands over IPC"| node_audio
node_main -->|"uses store"| node_localmusic
node_player -.->|"calls through IPC"| node_main
node_player -.->|"uses AMLL"| node_background
node_player -.->|"renders with AMLL"| node_lyricrender
node_background -.->|"implements interfaces"| node_amllapi
node_lyricrender -.->|"implements interfaces"| node_amllapi

click node_app "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/App.vue"
click node_routes "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/main.ts"
click node_search "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/views/Search.vue"
click node_playlistview "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/views/Playlist.vue"
click node_song "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/types/song.ts"
click node_playlists "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/stores/playlists.ts"
click node_player "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/stores/player.ts"
click node_lyrics "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/utils/lyricUtil.ts"
click node_playerui "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/components/player/PlayerBar.vue"
click node_queueui "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/components/player/PlayerQueueList.vue"
click node_localmusic "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/localMusicStore.ts"
click node_authui "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/stores/auth.ts"
click node_auth "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/authStore.ts"
click node_together "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/stores/listenTogether.ts"
click node_plugin "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/pluginSystem.ts"
click node_proxy "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/proxyServer.ts"
click node_settings "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/settingsStore.ts"
click node_main "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/index.ts"
click node_qzp "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/qzpController.ts"
click node_background "https://github.com/lqtmcstudio/qzmusic_pc/tree/master/amll-local/packages/core/src/bg-render"
click node_lyricrender "https://github.com/lqtmcstudio/qzmusic_pc/tree/master/amll-local/packages/core/src/lyric-player"
click node_amllapi "https://github.com/lqtmcstudio/qzmusic_pc/blob/master/amll-local/packages/core/src/interfaces.ts"

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_routes,node_search,node_playlistview,node_playerui,node_queueui,node_authui,node_together toneBlue
class node_song,node_playlists,node_player,node_lyrics toneAmber
class node_localmusic,node_auth,node_plugin,node_proxy,node_settings,node_main,node_qzp,node_audio toneMint
class node_background,node_lyricrender,node_amllapi toneRose
class node_user toneIndigo
```

## Components

### Desktop experience

- [App shell](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/App.vue): `src/renderer/src/App.vue`
- [Music views](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/main.ts): `src/renderer/src/main.ts`
- [Search](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/views/Search.vue): `src/renderer/src/views/Search.vue`
- [Playlist view](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/views/Playlist.vue): `src/renderer/src/views/Playlist.vue`
- [Playback controls](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/components/player/PlayerBar.vue): `src/renderer/src/components/player/PlayerBar.vue`
- [Queue controls](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/components/player/PlayerQueueList.vue): `src/renderer/src/components/player/PlayerQueueList.vue`
- [Account state](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/stores/auth.ts): `src/renderer/src/stores/auth.ts`
- [Listen together](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/stores/listenTogether.ts): `src/renderer/src/stores/listenTogether.ts`

### Playback and media

- [Song model](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/types/song.ts): `src/renderer/src/types/song.ts`
- [Playlist state](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/stores/playlists.ts): `src/renderer/src/stores/playlists.ts`
- [Player state](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/stores/player.ts): `src/renderer/src/stores/player.ts`
- [Lyric parsing](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/renderer/src/utils/lyricUtil.ts): `src/renderer/src/utils/lyricUtil.ts`

### Main-process services

- [Local music](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/localMusicStore.ts): `src/main/localMusicStore.ts`
- [Authentication](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/authStore.ts): `src/main/authStore.ts`
- [Plugin runtime](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/pluginSystem.ts): `src/main/pluginSystem.ts`
- [Media proxy](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/proxyServer.ts): `src/main/proxyServer.ts`
- [Settings](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/settingsStore.ts): `src/main/settingsStore.ts`
- [Electron IPC](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/index.ts): `src/main/index.ts`
- [QZPlayer bridge](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/src/main/qzpController.ts): `src/main/qzpController.ts`
- **Audio engine**

### AMLL rendering

- [Background render](https://github.com/lqtmcstudio/qzmusic_pc/tree/master/amll-local/packages/core/src/bg-render): `amll-local/packages/core/src/bg-render`
- [Lyric player](https://github.com/lqtmcstudio/qzmusic_pc/tree/master/amll-local/packages/core/src/lyric-player): `amll-local/packages/core/src/lyric-player`
- [AMLL interfaces](https://github.com/lqtmcstudio/qzmusic_pc/blob/master/amll-local/packages/core/src/interfaces.ts): `amll-local/packages/core/src/interfaces.ts`

### Other components

- **Listener**

## Connections

- Listener → App shell: uses (evidence: `src/renderer/src/App.vue`)
- App shell → Music views: hosts (evidence: `src/renderer/src/main.ts`)
- Music views → Search: routes to (evidence: `src/renderer/src/main.ts`)
- Music views → Playlist view: routes to (evidence: `src/renderer/src/main.ts`)
- Search → Player state: selects songs (evidence: `src/renderer/src/views/Search.vue`)
- Playlist view → Player state: queues songs (evidence: `src/renderer/src/views/Playlist.vue`)
- Playlist view → Playlist state: uses (evidence: `src/renderer/src/views/Playlist.vue`)
- Playlist state → Song model: stores (evidence: `src/renderer/src/stores/playlists.ts`)
- Player state → Song model: manages (evidence: `src/renderer/src/stores/player.ts`)
- Playback controls → Player state: controls (evidence: `src/renderer/src/components/player/PlayerBar.vue`)
- Queue controls → Player state: controls queue (evidence: `src/renderer/src/components/player/PlayerBar.vue`)
- Player state → Lyric parsing: parses lyrics (evidence: `src/renderer/src/stores/player.ts`)
- Player state → Listen together: syncs playback (evidence: `src/renderer/src/stores/player.ts`)
- App shell → Account state: initializes (evidence: `src/renderer/src/App.vue`)
- Account state → Authentication: requests account state
- Search → Plugin runtime: searches via
- Player state → Plugin runtime: fetches lyrics (evidence: `src/renderer/src/stores/player.ts`)
- Electron IPC → Plugin runtime: registers service (evidence: `src/main/index.ts`)
- Electron IPC → Media proxy: starts proxy (evidence: `src/main/index.ts`)
- Electron IPC → Settings: loads settings (evidence: `src/main/index.ts`)
- Electron IPC → Authentication: handles auth (evidence: `src/main/index.ts`)
- Electron IPC → QZPlayer bridge: starts player bridge (evidence: `src/main/index.ts`)
- QZPlayer bridge → Audio engine: commands over IPC (evidence: `README.md`)
- Electron IPC → Local music: uses store (evidence: `src/main/index.ts`)
- Player state → Electron IPC: calls through IPC
- Player state → Background render: uses AMLL (evidence: `README.md`)
- Player state → Lyric player: renders with AMLL (evidence: `README.md`)
- Background render → AMLL interfaces: implements interfaces
- Lyric player → AMLL interfaces: implements interfaces
