How dhruvesh07/echomusic-desktop works
Echo Music Desktop is a Windows music-streaming client centered on discovering YouTube Music content and playing it through a desktop player. The main workflow runs from the desktop shell and search/home/library screens through the repository and Innertube API, then into queue management, stream resolution, and FFmpeg audio or video playback. Local playlists, listening history, taste-based recommendations, and lyrics are supporting product branches. The README documents additional UI and playback capabilities; some implementation paths are unsampled, so those relationships are shown only where documented.
Main entry points: Playback.kt Queue and playback · Main.kt App shell · YouTube.kt YouTube facade · YouTubeRepository.kt YouTube repository
Components 23
Desktop experience
- App shell
desktop/src/main/kotlin/echo/music/desktop/Main.kt - Home screen
desktop/src/main/kotlin/echo/music/desktop/ui/HomeScreen.kt - Search screen
desktop/src/main/kotlin/echo/music/desktop/ui/SearchScreen.kt - Library screen
desktop/src/main/kotlin/echo/music/desktop/ui/LibraryScreen.kt - Player views
desktop/src/main/kotlin/echo/music/desktop/ui/player/FullPlayer.kt
Catalog and domain
- YouTube repository
desktop/src/main/kotlin/echo/music/desktop/data/YouTubeRepository.kt - YouTube facade
innertube/src/main/kotlin/com/music/innertube/YouTube.kt - Catalog items
innertube/src/main/kotlin/com/music/innertube/models/YTItem.kt - Search parsing
innertube/src/main/kotlin/com/music/innertube/pages/SearchSummaryPage.kt - Song model
domain/src/main/kotlin/echo/music/domain/models/Song.kt
Playback
- Queue and playback
desktop/src/main/kotlin/echo/music/desktop/playback/Playback.kt - Stream resolver
desktop/src/main/kotlin/echo/music/desktop/playback/StreamResolver.kt - Audio engine
desktop/src/main/kotlin/echo/music/desktop/playback/FfmpegPlayer.kt - Video engine
desktop/src/main/kotlin/echo/music/desktop/playback/VideoEngine.kt
Personalization
- Play history
desktop/src/main/kotlin/echo/music/desktop/data/PlayHistory.kt - Taste model
desktop/src/main/kotlin/echo/music/desktop/data/TasteModel.kt - Recommendations
desktop/src/main/kotlin/echo/music/desktop/data/Recommendations.kt - Local playlists
desktop/src/main/kotlin/echo/music/desktop/data/Playlists.kt - Local state
desktop/src/main/kotlin/echo/music/desktop/data
Lyrics
- Lyrics service
desktop/src/main/kotlin/echo/music/desktop/lyrics/DesktopLyricsService.kt - Lyrics providers
betterlyrics/src/main/kotlin/com/music/echo/betterlyrics/BetterLyrics.kt
Other components
- Listener
- FFmpeg
Connections 30
- Listener → App shell: opens
README.md - App shell → Home screen: shows
desktop/src/main/kotlin/echo/music/desktop/Main.kt - App shell → Search screen: shows
desktop/src/main/kotlin/echo/music/desktop/Main.kt - App shell → Library screen: shows
desktop/src/main/kotlin/echo/music/desktop/Main.kt - App shell → Player views: shows
desktop/src/main/kotlin/echo/music/desktop/Main.kt - Search screen → YouTube repository: searches
desktop/src/main/kotlin/echo/music/desktop/ui/SearchScreen.kt - Home screen → YouTube repository: loads content
desktop/src/main/kotlin/echo/music/desktop/ui/HomeScreen.kt - Library screen → YouTube repository: loads content
- YouTube repository → YouTube facade: requests content
desktop/src/main/kotlin/echo/music/desktop/data/YouTubeRepository.kt - YouTube facade → Catalog items: returns items
innertube/src/main/kotlin/com/music/innertube/models/YTItem.kt - YouTube facade → Search parsing: parses results
innertube/src/main/kotlin/com/music/innertube/pages/SearchSummaryPage.kt - Search screen → Taste model: records query
desktop/src/main/kotlin/echo/music/desktop/ui/SearchScreen.kt - Player views → Queue and playback: controls
desktop/src/main/kotlin/echo/music/desktop/ui/player/FullPlayer.kt - Queue and playback → YouTube facade: loads playback data
desktop/src/main/kotlin/echo/music/desktop/playback/Playback.kt - Queue and playback → Stream resolver: resolves stream
desktop/src/main/kotlin/echo/music/desktop/playback/Playback.kt - Queue and playback → Audio engine: starts audio
desktop/src/main/kotlin/echo/music/desktop/playback/Playback.kt - Queue and playback → Video engine: starts video
desktop/src/main/kotlin/echo/music/desktop/playback/Playback.kt - Video engine → Stream resolver: uses resolved stream
desktop/src/main/kotlin/echo/music/desktop/playback/VideoEngine.kt - Audio engine → FFmpeg: decodes audio
- Video engine → FFmpeg: decodes video
desktop/src/main/kotlin/echo/music/desktop/playback/VideoEngine.kt - Queue and playback → Play history: records plays
desktop/src/main/kotlin/echo/music/desktop/playback/Playback.kt - Queue and playback → Taste model: records starts
desktop/src/main/kotlin/echo/music/desktop/playback/Playback.kt - Taste model → Recommendations: informs picks
desktop/src/main/kotlin/echo/music/desktop/data/TasteModel.kt - Library screen → Local playlists: manages
desktop/src/main/kotlin/echo/music/desktop/ui/LibraryScreen.kt - Queue and playback → Local playlists: plays selections
- Queue and playback → Lyrics service: looks up lyrics
- Lyrics service → Lyrics providers: queries providers
desktop/src/main/kotlin/echo/music/desktop/lyrics/DesktopLyricsService.kt - Play history → Local state: persists locally
desktop/src/main/kotlin/echo/music/desktop/data/TasteModel.kt - Local playlists → Local state: persists locally
- Recommendations → Local state: uses local data
desktop/src/main/kotlin/echo/music/desktop/data/TasteModel.kt