How lqtmcstudio/qzmusic_pc works
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: player.ts Player state · index.ts Electron IPC · App.vue App shell · main.ts Music views
Components 24
Desktop experience
- App shell
src/renderer/src/App.vue - Music views
src/renderer/src/main.ts - Search
src/renderer/src/views/Search.vue - Playlist view
src/renderer/src/views/Playlist.vue - Playback controls
src/renderer/src/components/player/PlayerBar.vue - Queue controls
src/renderer/src/components/player/PlayerQueueList.vue - Account state
src/renderer/src/stores/auth.ts - Listen together
src/renderer/src/stores/listenTogether.ts
Playback and media
- Song model
src/renderer/src/types/song.ts - Playlist state
src/renderer/src/stores/playlists.ts - Player state
src/renderer/src/stores/player.ts - Lyric parsing
src/renderer/src/utils/lyricUtil.ts
Main-process services
- Local music
src/main/localMusicStore.ts - Authentication
src/main/authStore.ts - Plugin runtime
src/main/pluginSystem.ts - Media proxy
src/main/proxyServer.ts - Settings
src/main/settingsStore.ts - Electron IPC
src/main/index.ts - QZPlayer bridge
src/main/qzpController.ts - Audio engine
AMLL rendering
- Background render
amll-local/packages/core/src/bg-render - Lyric player
amll-local/packages/core/src/lyric-player - AMLL interfaces
amll-local/packages/core/src/interfaces.ts
Other components
- Listener
Connections 29
- Listener → App shell: uses
src/renderer/src/App.vue - App shell → Music views: hosts
src/renderer/src/main.ts - Music views → Search: routes to
src/renderer/src/main.ts - Music views → Playlist view: routes to
src/renderer/src/main.ts - Search → Player state: selects songs
src/renderer/src/views/Search.vue - Playlist view → Player state: queues songs
src/renderer/src/views/Playlist.vue - Playlist view → Playlist state: uses
src/renderer/src/views/Playlist.vue - Playlist state → Song model: stores
src/renderer/src/stores/playlists.ts - Player state → Song model: manages
src/renderer/src/stores/player.ts - Playback controls → Player state: controls
src/renderer/src/components/player/PlayerBar.vue - Queue controls → Player state: controls queue
src/renderer/src/components/player/PlayerBar.vue - Player state → Lyric parsing: parses lyrics
src/renderer/src/stores/player.ts - Player state → Listen together: syncs playback
src/renderer/src/stores/player.ts - App shell → Account state: initializes
src/renderer/src/App.vue - Account state → Authentication: requests account state
- Search → Plugin runtime: searches via
- Player state → Plugin runtime: fetches lyrics
src/renderer/src/stores/player.ts - Electron IPC → Plugin runtime: registers service
src/main/index.ts - Electron IPC → Media proxy: starts proxy
src/main/index.ts - Electron IPC → Settings: loads settings
src/main/index.ts - Electron IPC → Authentication: handles auth
src/main/index.ts - Electron IPC → QZPlayer bridge: starts player bridge
src/main/index.ts - QZPlayer bridge → Audio engine: commands over IPC
README.md - Electron IPC → Local music: uses store
src/main/index.ts - Player state → Electron IPC: calls through IPC
- Player state → Background render: uses AMLL
README.md - Player state → Lyric player: renders with AMLL
README.md - Background render → AMLL interfaces: implements interfaces
- Lyric player → AMLL interfaces: implements interfaces