How mayopi/spotif-ish works
Spotifish is a bare-bones Android music player. The user-facing flow spans Compose screens and ViewModels, domain use cases and repository contracts, data sources/repositories, and Media3 playback. The README also documents local MediaStore scanning, favorites/playlists persistence, settings, and a deliberately stubbed Drive integration. Source excerpts contain no application code, so arrows beyond documented module responsibilities are marked unverified rather than presented as inspected call paths.
Main entry points: SpotifishApp.kt App navigation · MainViewModel.kt Screen state · repository Repository contracts · MainActivity.kt App entry
Components 19
Android app
- App entry
app/src/main/java/com/example/spotifish/MainActivity.kt - App navigation
app/src/main/java/com/example/spotifish/ui/SpotifishApp.kt - Music screens
app/src/main/java/com/example/spotifish/ui/HomeScreens.kt - Search screen
app/src/main/java/com/example/spotifish/ui/SearchScreen.kt - Library screen
app/src/main/java/com/example/spotifish/ui/LibraryScreen.kt - Settings screen
app/src/main/java/com/example/spotifish/ui/SettingsScreen.kt - Player screen
app/src/main/java/com/example/spotifish/ui/PlayerScreen.kt - Screen state
app/src/main/java/com/example/spotifish/MainViewModel.kt - Player state
app/src/main/java/com/example/spotifish/ui/player/PlayerViewModel.kt
Domain logic
- Music use cases
domain/src/main/java/com/example/spotifish/domain/usecase - Repository contracts
domain/src/main/java/com/example/spotifish/domain/repository
Music and data
- Local music scan
data/src/main/java/com/example/spotifish/data/local/MediaStoreLocalMusicDataSource.kt - Music repositories
data/src/main/java/com/example/spotifish/data/repository/RemoteMusicRepository.kt - Favorites and playlists
data/src/main/java/com/example/spotifish/data/repository/RemoteFavoritesRepository.kt - Settings storage
data/src/main/java/com/example/spotifish/data/repository/DefaultSettingsRepository.kt - Drive stub
data/src/main/java/com/example/spotifish/data/repository/RemoteDriveRepository.kt
Playback
- Playback controller
player/src/main/java/com/example/spotifish/player/controller/Media3PlaybackController.kt - Playback service
player/src/main/java/com/example/spotifish/player/service/PlaybackService.kt
Other components
- Listener
Connections 21
- Listener → App entry: opens app
- App entry → App navigation: starts navigation
- App navigation → Music screens: shows screens
- App navigation → Search screen: shows screens
- App navigation → Library screen: shows screens
- App navigation → Settings screen: shows screens
- App navigation → Player screen: shows screens
- Music screens → Screen state: observes state
- Search screen → Screen state: observes state
- Library screen → Screen state: observes state
- Settings screen → Screen state: observes state
- Screen state → Music use cases: invokes
- Music use cases → Repository contracts: uses contracts
- Local music scan → Music repositories: provides local tracks
- Music repositories → Repository contracts: implements contracts
- Favorites and playlists → Repository contracts: implements contracts
- Settings storage → Repository contracts: implements contracts
- Drive stub → Repository contracts: implements contract
- Player screen → Player state: observes state
- Player state → Playback controller: controls playback
- Playback controller → Playback service: uses service