An Android music player with hierarchical folder browsing, Chromecast support, and smart flat-list views for large libraries.
- Hierarchical folder browser — navigate your storage tree with human-friendly names (Internal Storage, SD Card, etc.)
- Play MP3, WAV, OGG, FLAC, M4A, and other common audio formats
- Playback controls: play/pause, previous/next track, volume up/down
- Shuffle mode with visual indicator (bright yellow when active) and smart auto-scroll
- All Tracks flat view — when a folder subtree contains many single-track directories (e.g. an iTunes library of singles), an "All Tracks" chip appears that collapses all leaf-folder tracks into one scrollable list showing artist and title
- Song search — search icon in the top bar filters by title, artist, or album within the folder subtree you're currently browsing; tap a result to play it
- Seek bar for track position
- Now Playing view with album art, track info, and seek slider
- Chromecast support — stream to any Cast device on the local network
- System back button navigates up the folder tree (exits only when at the root)
Download the latest APK from the Releases page and install it on your Android device. See INSTALLATION.md for detailed instructions on how to sideload the app.
./gradlew assembleDebug- Kotlin
- Jetpack Compose with Material 3
- Android MediaPlayer API
- ViewModel with StateFlow
see: