qingj01/mineplayer

MinePlayer is a native Android app for playing music stored locally on your phone, built around an immersive particle visualizer rather than a plain playback screen. It works fully offline for its core features and turns each album cover into a grid of moving particles that react to the music as it plays. The visual style is ported from an earlier web project called Mineradio, with its original graphics shaders rewritten for mobile using OpenGL ES. The particle display samples the album cover into thousands of points and adds a glow effect on top, while audio is analyzed in real time so the particles move with the rhythm and beat of the song. Several visual presets are available, such as silk, vinyl, planet, and tunnel styles, and users can adjust how strongly the particles react. Playback itself is handled through Android's Media3 library, supporting background play, lock screen controls, shuffle and repeat modes, and resuming the last played track on launch. The app also works with Android Auto, exposing a browsable list of songs, albums, and artists for use in a car. It supports both embedded and external lyric files, shown in two languages if available, and includes audio tools like an equalizer, volume balancing, and gapless playback. For managing music, MinePlayer can scan the whole device or just chosen folders, automatically labels songs by audio quality, and tracks basic listening statistics such as most played songs and artists. The interface supports light and dark themes, adapts to tablets and landscape orientation, and can follow Android's dynamic color system. Building from source requires JDK 17 and Gradle, with release builds signed through environment variables or falling back to a debug signature. The project requests permissions for reading music files, background playback, and checking for updates through GitHub Releases, internet access is used only for that update check. The project is released under the GNU GPL-3.0 license.