How clash-projects/lastwave-desktop works
LastWave is a desktop music player. Its principal workflow is listening to music through playback, with the UI also exposing synced lyrics, smart playlists, YouTube Music, and Last.fm scrobbling. The README documents these product capabilities but does not show the Dart runtime wiring, so feature-level connections are documented at a high level only. Native Windows and Linux startup and Windows audio-channel relationships are supported by the sampled source; unsampled Dart internals are represented by their exact tree paths.
Main entry points: main.dart LastWave app · my_application.cc Linux app host · main.cpp Windows launcher · flutter_window.cpp Flutter window
Components 22
Desktop experience
- LastWave app
lib/main.dart - App shell
lib/ui/app_shell/app_shell.dart - Library views
lib/ui/collections
Playback and audio
- Playback service
lib/features/player/playback_service.dart - Player state
lib/features/player/player_state.dart - Lossless source
lib/features/lossless/lossless_source.dart - Audio output
lib/features/audio_output/output_controller.dart
Music services
- YouTube Music
lib/features/innertube/innertube_api.dart - Music search
lib/features/search/search_repository.dart - Downloads
lib/features/downloads/download_manager.dart
Personal features
- Synced lyrics
lib/features/lyrics/lyrics_repository.dart - Smart playlists
lib/features/feed/local_taste.dart - Last.fm scrobbling
lib/features/lastfm/scrobble_repository.dart - App database
lib/core/storage/app_database.dart
Platform integration
- Windows launcher
windows/runner/main.cpp - Flutter window
windows/runner/flutter_window.cpp - WASAPI channel
windows/runner/wasapi_channel.cpp - WASAPI engine
windows/runner/wasapi_engine.cpp - Linux app host
linux/runner/my_application.cc - Linux plugins
linux/flutter/generated_plugin_registrant.cc - WebView guard
linux/runner/yt_webview_guard.h
Other components
- Listener
Connections 13
- Listener → LastWave app: uses
README.md - LastWave app → Playback service: plays music
README.md - LastWave app → Synced lyrics: shows lyrics
README.md - LastWave app → Smart playlists: generates playlists
README.md - LastWave app → Last.fm scrobbling: scrobbles listens
README.md - LastWave app → YouTube Music: integrates
README.md - LastWave app → Windows launcher: starts on Windows
windows/runner/main.cpp - Windows launcher → Flutter window: creates window
windows/runner/main.cpp - Flutter window → WASAPI channel: owns channel
- WASAPI channel → WASAPI engine: uses
windows/runner/wasapi_channel.cpp - LastWave app → Linux app host: starts on Linux
- Linux app host → Linux plugins: registers plugins
linux/runner/my_application.cc - Linux app host → WebView guard: registers guard
linux/runner/my_application.cc