How metrolistgroup/metrolist works
Metrolist is a cross-platform YouTube Music client. The main user journey is to browse or import music, select a track, and play it; the repository also exposes recognition, shared listening, casting, downloads, backups, and integrations. The graph combines documented capabilities with paths identified in the tree and SOURCE INDEX. Most implementation links are unverified because the relevant source was not excerpted, so those edges are dashed rather than asserted as observed calls.
Main entry points: MainActivity.kt Android app · MusicService.kt Android playback · Main.kt Desktop app · MusicRecognitionService.kt Music recognition
Components 22
App experience
- Android app
androidApp/src/main/kotlin/com/metrolist/android/MainActivity.kt - Desktop app
desktopApp/src/jvmMain/kotlin/com/metrolist/desktop/Main.kt - iOS app
shared/src/iosMain/kotlin/com/metrolist/shared/MainViewController.kt - Animated artwork
shared/src/commonMain/kotlin/com/metrolist/shared/api/artwork/AnimatedArtworkService.kt
Playback and storage
- Android playback
androidApp/src/main/kotlin/com/metrolist/android/playback/MusicService.kt - Audio cache
androidApp/src/main/kotlin/com/metrolist/android/playback/AudioCacheManager.kt - Android downloads
androidApp/src/main/kotlin/com/metrolist/android/playback/SongDownloadManager.kt - Desktop downloads
desktopApp/src/jvmMain/kotlin/com/metrolist/desktop/storage/DownloadManager.kt
Shared platform services
- Preferences
shared/src/commonMain/kotlin/com/metrolist/shared/settings/Settings.kt - Music database
shared/src/commonMain/kotlin/com/metrolist/shared/db/MusicDatabase.kt - Video resolver
shared/src/commonMain/kotlin/com/metrolist/shared/api/musicvideo/MusicVideoResolver.kt - Playback resource
shared/src/commonMain/kotlin/com/metrolist/shared/youtube/playback/PlaybackResource.kt
Discovery and integrations
- Playlist import
androidApp/src/main/kotlin/com/metrolist/android/playlistimport/AndroidPlaylistImportService.kt - Music recognition
androidApp/src/main/kotlin/com/metrolist/android/recognition/MusicRecognitionService.kt - Listen Together
shared/src/commonMain/kotlin/com/metrolist/shared/listentogether/ListenTogetherManager.kt - Device connection
shared/src/commonMain/kotlin/com/metrolist/shared/deviceconnect/DeviceConnectManager.kt - Android cast discovery
androidApp/src/main/kotlin/com/metrolist/android/cast/AndroidMdnsCastDiscovery.kt - Backup and restore
androidApp/src/main/kotlin/com/metrolist/android/backup/BackupRestoreManager.kt
Other components
- Listener
- YouTube Music
- Shazam
- Cast devices
Connections 22
- Listener → Android app: uses
README.md - Listener → Desktop app: uses
README.md - Listener → iOS app: uses
README.md - Android app → Android playback: starts playback
androidApp/src/main/kotlin/com/metrolist/android/playback/MusicService.kt - Desktop app → YouTube Music: requests music
- Android playback → YouTube Music: streams music
README.md - Android playback → Playback resource: uses stream data
androidApp/src/main/kotlin/com/metrolist/android/playback/MusicService.kt - Video resolver → Playback resource: resolves video
- Android playback → Audio cache: uses cache
- Android playback → Music database: persists playback
androidApp/src/main/kotlin/com/metrolist/android/playback/MusicService.kt - Android app → Android downloads: downloads tracks
androidApp/src/main/kotlin/com/metrolist/android/playback/SongDownloadManager.kt - Desktop app → Desktop downloads: downloads tracks
desktopApp/src/jvmMain/kotlin/com/metrolist/desktop/Main.kt - Android app → Playlist import: imports playlists
README.md - Android app → Music recognition: recognizes music
README.md - Music recognition → Shazam: matches audio
README.md - Listener → Listen Together: shares playback
README.md - Listener → Device connection: connects devices
README.md - Android app → Android cast discovery: discovers devices
- Android cast discovery → Cast devices: discovers
- Listener → Backup and restore: backs up library
README.md - Android app → Preferences: reads preferences
androidApp/src/main/kotlin/com/metrolist/android/MainActivity.kt - Android app → Animated artwork: loads artwork