How inuhepott/archivetune works
ArchiveTune is an Android YouTube Music-oriented player with local-library support. The main user journey is browsing or searching music, turning results into playable queue items, and listening through the background media service; lyrics, discovery, statistics, and social integrations extend that experience. The graph also preserves documented audio, account, and customization capabilities. Source excerpts are partial, so some subsystem links are documented by the README or reference index rather than verified call sites; uncertain links are omitted.
Main entry points: MusicService.kt Music service · innertube YouTube Music access · MusicDatabase.kt Music database · LyricsPreloadManager.kt Lyrics preloader
Components 22
App experience
- Browse and search
app/src/main/kotlin/moe/koiverse/archivetune/ui/screens - Player interface
app/src/main/kotlin/moe/koiverse/archivetune/ui/player/Player.kt - App shell
app/src/main/kotlin/moe/koiverse/archivetune/MainActivity.kt
Music access
- YouTube Music access
innertube/src/main/kotlin/moe/koiverse/archivetune/innertube - Track metadata
app/src/main/kotlin/moe/koiverse/archivetune/models/MediaMetadata.kt - Local music scan
app/src/main/kotlin/moe/koiverse/archivetune/localmedia/LocalSongScanner.kt
Playback
- Music service
app/src/main/kotlin/moe/koiverse/archivetune/playback/MusicService.kt - Playback queues
app/src/main/kotlin/moe/koiverse/archivetune/playback/queues - Audio processing
app/src/main/kotlin/moe/koiverse/archivetune/playback - Offline downloads
app/src/main/kotlin/moe/koiverse/archivetune/playback/ExoDownloadService.kt
Lyrics and discovery
- Lyrics retrieval
app/src/main/kotlin/moe/koiverse/archivetune/lyrics/LyricsHelper.kt - Lyrics preloader
app/src/main/kotlin/moe/koiverse/archivetune/lyrics/LyricsPreloadManager.kt - Synced lyrics
app/src/main/kotlin/moe/koiverse/archivetune/ui/component/Lyrics.kt - Lyrics translation
app/src/main/kotlin/moe/koiverse/archivetune/ai/AiTextService.kt - Music recognition
app/src/main/kotlin/moe/koiverse/archivetune/musicrecognition/MusicRecognitionTileService.kt
Library and integrations
- Music database
app/src/main/kotlin/moe/koiverse/archivetune/db/MusicDatabase.kt - Listening statistics
app/src/main/kotlin/moe/koiverse/archivetune/ui/screens/StatsScreen.kt - Listening integrations
app/src/main/kotlin/moe/koiverse/archivetune/utils/ScrobbleManager.kt - Shared listening
app/src/main/kotlin/moe/koiverse/archivetune/together
Other components
- Listener
- YouTube service
- External services
Connections 27
- Listener → App shell: opens
README.md - App shell → Browse and search: presents
app/src/main/kotlin/moe/koiverse/archivetune/MainActivity.kt - Listener → Browse and search: browses
README.md - Browse and search → YouTube Music access: requests catalog
app/src/main/kotlin/moe/koiverse/archivetune/ui/screens/settings/StorageSettings.kt - YouTube Music access → YouTube service: requests data
- YouTube Music access → Track metadata: maps results
- Local music scan → Music database: indexes songs
- Track metadata → Music service: supplies tracks
app/src/main/kotlin/moe/koiverse/archivetune/playback/MusicService.kt - Music service → YouTube Music access: uses
app/src/main/kotlin/moe/koiverse/archivetune/playback/MusicService.kt - Music service → Music database: reads and writes
app/src/main/kotlin/moe/koiverse/archivetune/playback/MusicService.kt - Music service → Lyrics preloader: preloads lyrics
app/src/main/kotlin/moe/koiverse/archivetune/playback/MusicService.kt - Music service → Playback queues: uses queue
app/src/main/kotlin/moe/koiverse/archivetune/playback/MusicService.kt - Music service → Audio processing: processes audio
README.md - Music service → Offline downloads: starts downloads
app/src/main/kotlin/moe/koiverse/archivetune/playback/MusicService.kt - Music service → Player interface: drives playback
app/src/main/kotlin/moe/koiverse/archivetune/playback/MusicService.kt - Lyrics preloader → Music database: checks and caches
app/src/main/kotlin/moe/koiverse/archivetune/lyrics/LyricsPreloadManager.kt - Lyrics preloader → Lyrics retrieval: fetches lyrics
app/src/main/kotlin/moe/koiverse/archivetune/lyrics/LyricsPreloadManager.kt - Lyrics retrieval → External services: queries providers
- Synced lyrics → Lyrics retrieval: displays lyrics
- Synced lyrics → Lyrics translation: translates text
- Music recognition → External services: identifies music
- Listening statistics → Music database: reads history
- Listening integrations → External services: syncs listening
README.md - Shared listening → External services: coordinates playback
- Listener → Synced lyrics: views lyrics
README.md - Listener → Music recognition: recognizes music
README.md - Listener → Listening statistics: reviews listening
README.md