How geniusqa/aurora works
Aurora is a native Android Spotify client: the user signs in through Spotify, browses Spotify content, and controls the official Web Player hosted invisibly in the app. The app also provides separate offline downloads from Tidal or Qobuz, local-file playback, lyrics and translations, Genius meanings, and synchronized YouTube music videos. The graph emphasizes these product stages and runtime layers. Some feature implementations are unsampled; those nodes use exact paths from the tree, and uncertain implementation-level connections are omitted.
Main entry points: SpotifyApi.kt Spotify API · MainActivity.kt Activity and login · WebPlayerHost.kt Web Player host · OfflineDownloader.kt Offline downloader
Components 25
Android experience
- Activity and login
base/app/src/main/java/app/myspoti/MainActivity.kt - App navigation
base/app/src/main/java/com/music/spotui/App.kt - Catalog screens
base/app/src/main/java/com/music/spotui/ui/screens/ContextScreen.kt - App data API
base/app/src/main/java/com/music/spotui/data/api/Api.kt
Spotify playback
- API contract
base/api/src/main/kotlin/app/myspoti/api/Api.kt - Runtime wiring
base/host-android/src/main/kotlin/app/myspoti/host/android/MyspotiRuntime.kt - Spotify API
base/api-spotify/src/main/kotlin/app/myspoti/spotify/SpotifyApi.kt - Player controls
base/api-spotify/src/main/kotlin/app/myspoti/spotify/SpotifyPlayer.kt - Player bridge
base/api-spotify/src/main/resources/bridge/player-bridge.js - Web Player host
base/host-android/src/main/kotlin/app/myspoti/host/android/WebPlayerHost.kt - Android media service
base/host-android/src/main/kotlin/app/myspoti/host/android/PlaybackService.kt
Offline listening
- Offline collections
base/app/src/main/java/com/music/spotui/data/offline/OfflineCollections.kt - Offline downloader
base/app/src/main/java/com/music/spotui/data/offline/OfflineDownloader.kt - Encrypted download store
base/app/src/main/java/com/music/spotui/data/offline/OfflineStore.kt - Lossless sources
base/app/src/main/java/com/music/spotui/lossless/ZarzSession.kt - Local music
base/app/src/main/java/com/music/spotui/data/local/LocalMusic.kt
Listening features
- Lyrics and translation
base/app/src/main/java/com/music/spotui/data/api/LyricsApi.kt - Song meanings
base/app/src/main/java/com/music/spotui/data/api/GeniusMeaning.kt - Music video controller
base/app/src/main/java/com/music/spotui/video/MusicVideoController.kt - Listen history
base/app/src/main/java/com/music/spotui/data/local/ListenHistory.kt - Data saver
base/app/src/main/java/com/music/spotui/data/DataSaver.kt
Other components
- Listener
- Spotify
- Tidal or Qobuz
- YouTube clips
Connections 28
- Listener → Activity and login: opens app
README.md - Activity and login → Runtime wiring: starts session
base/app/src/main/java/app/myspoti/MainActivity.kt - Activity and login → App navigation: shows screens
base/app/src/main/java/app/myspoti/MainActivity.kt - App navigation → Catalog screens: navigates to
base/app/src/main/java/com/music/spotui/App.kt - Catalog screens → App data API: loads content
base/app/src/main/java/com/music/spotui/ui/screens/ContextScreen.kt - App data API → API contract: uses contract
base/app/src/main/java/com/music/spotui/data/api/Api.kt - Runtime wiring → Spotify API: creates
base/host-android/src/main/kotlin/app/myspoti/host/android/MyspotiRuntime.kt - Spotify API → API contract: implements
README.md - Spotify API → Player controls: provides controls
base/api-spotify/src/main/kotlin/app/myspoti/spotify/SpotifyPlayer.kt - Spotify API → Web Player host: uses hosted player
README.md - Web Player host → Player bridge: runs bridge
README.md - Web Player host → Spotify: loads Web Player
README.md - Player controls → Spotify: controls playback
README.md - Android media service → Player controls: exposes media controls
- Spotify → Listen history: reports plays
README.md - Offline collections → Offline downloader: synchronizes downloads
- Offline downloader → Lossless sources: obtains audio
- Lossless sources → Tidal or Qobuz: finds recordings
README.md - Offline downloader → Encrypted download store: stores downloads
- Listener → Local music: plays local files
README.md - Listener → Lyrics and translation: views lyrics
README.md - Lyrics and translation → Spotify: looks up lyrics
- Listener → Song meanings: opens meanings
README.md - Song meanings → Spotify: uses song context
- Listener → Music video controller: plays videos
README.md - Music video controller → YouTube clips: resolves clips
README.md - Listener → Data saver: sets data policy
README.md - Data saver → Runtime wiring: gates player startup
base/app/src/main/java/com/music/spotui/di/Graph.kt