How qiannqq/elia-music-desktop works
Elia Music is a Flutter Windows desktop music player. The principal workflow is searching QQ Music or NetEase Music, importing a song or playlist, then listening with synchronized lyrics or downloading tracks; local playlists, themes, video backgrounds and Windows integrations are supporting capabilities. The Dart implementation is represented at component or subsystem level because its source was not excerpted. Native runner relationships are shown where registration or calls are visible in the excerpts; other feature links rely on the README.
Main entry points: player_controller.dart Player Controller · flutter_window.cpp Flutter Window · search_page.dart Search Page · settings_page.dart Settings Page
Components 27
Application
- App Entry
lib/main.dart - App Shell
lib/ui/app_shell.dart - App State
lib/state/app_state.dart - Search Page
lib/ui/pages/search_page.dart - Playlist Page
lib/ui/pages/playlist_page.dart
Music Services
- Music Providers
lib/services - API Client
lib/services/api_client.dart - Song Model
lib/models/song.dart - Playlist Model
lib/models/playlist.dart - Audio Cache
lib/services/audio_cache.dart
Playback Experience
- Player Controller
lib/services/player_controller.dart - Local Audio Proxy
lib/services/http_server.dart - Lyrics Services
lib/services/lyric_cache.dart - Now Playing
lib/ui/now_playing.dart - Queue Panel
lib/ui/widgets/queue_panel.dart - Video Background
lib/services/video_bg.dart
Library And Settings
- Local Store
lib/core/local_store.dart - Settings Page
lib/ui/pages/settings_page.dart - Theme Controller
lib/state/theme_controller.dart
Windows Integration
- Flutter Window
windows/runner/flutter_window.cpp - SMTC Bridge
windows/runner/smtc_bridge.cpp - Lyric Island
windows/runner/lyric_island.cpp - Audio Probe Bridge
windows/runner/audio_probe_bridge.cpp - Audio Probe
windows/runner/audio_probe.cpp - Window Effects
windows/runner/window_fx.cpp - Window Chrome
windows/runner/window_chrome.cpp
Other components
- Listener
Connections 21
- Listener → Search Page: searches
README.md - Listener → Playlist Page: imports playlists
README.md - Search Page → Music Providers: searches catalogs
README.md - Music Providers → API Client: uses API client
- Search Page → Song Model: shows results
- Playlist Page → Playlist Model: manages playlists
- Listener → Player Controller: listens
README.md - Player Controller → Local Audio Proxy: streams through
README.md - Player Controller → Lyrics Services: synchronizes lyrics
README.md - Player Controller → Audio Cache: downloads tracks
README.md - Player Controller → Now Playing: updates display
- Player Controller → Queue Panel: manages queue
- Settings Page → Local Store: configures
- Settings Page → Theme Controller: changes theme
README.md - Video Background → Now Playing: provides backdrop
- Flutter Window → SMTC Bridge: registers bridge
windows/runner/flutter_window.cpp - Flutter Window → Lyric Island: registers bridge
windows/runner/flutter_window.cpp - Flutter Window → Audio Probe Bridge: registers bridge
windows/runner/flutter_window.cpp - Flutter Window → Window Effects: registers bridge
windows/runner/flutter_window.cpp - Audio Probe Bridge → Audio Probe: invokes probe
windows/runner/audio_probe_bridge.cpp - Flutter Window → Window Chrome: uses hit testing
windows/runner/flutter_window.cpp