5.2 KiB
5.2 KiB
Music
A private, offline music player for Android with DSD, bit-perfect USB output and a parametric equalizer.
Current version: v0.3.0
Source code and releases: git.hnet.sh/hkr/music
Overview
Music plays the audio files in the folders you choose and nothing else. It has no internet permission, doesn’t ask for access to your storage or media, and keeps nothing about you: the library, playlists and settings stay on the device. It is built for people who keep their own collection – FLAC, hi-res and DSD included – and want a player that respects it.
Screenshots

Features
Library
- Your folders only: Add the folders with your music through Android’s folder picker; Music sees nothing else on the phone
- Albums, artists, tracks and playlists: Four views in the order you choose, opening on the one you pick or the last one used; albums group by album and album artist, with compilations and multi-disc albums grouped properly
- Search: Albums, artists, tracks and playlists at once, ignoring diacritics
- Scanning: New and changed files are picked up on every start, or on demand; very short files (sounds, voice notes) can be left out
- Play counts: Tracks you listen to at least halfway are counted, for a Most played sort and an artist’s most played tracks – a number per track, nothing more. Counting can be switched off and the counts reset
Playback
- Formats: FLAC, ALAC, AAC, MP3, Ogg Vorbis and Opus, with gapless playback; DSD (DSF and DSDIFF) converted to PCM, or sent unconverted as DoP over bit-perfect output
- ReplayGain: Track, album or automatic, with a pre-amp for files without tags and clipping prevention
- Equalizer: Parametric, up to 20 peak and shelf filters with a pre-amp and a response curve; your own presets, built-in ones, and import and export of Equalizer APO text (the format AutoEq publishes)
- Output devices: Music remembers the outputs it has played on – the speaker, wired and Bluetooth headphones, USB DACs – and each can have its own equalizer preset, applied when playback switches to it. Bluetooth devices are told apart by name, so no extra permission is needed
- Bit-perfect output: With a USB DAC, the audio goes out unchanged at each file’s own sample rate, bypassing the system mixer; switched on for each DAC separately, and the Output page shows what the connected device accepts
- Queue: Reorder, remove with Undo, save as a playlist; the queue shows shuffle and repeat as they play and is kept across restarts
- Now playing: Cover, technical details of the file, the ReplayGain applied or bit-perfect output, seek bar, volume, the equalizer and the track’s tags
Playlists
- Your own playlists and Starred, kept in the app
- Import and export of M3U, M3U8, PLS and XSPF; unavailable tracks keep their place and come back when found
Interface
- Material 3 Expressive design with your phone’s colors
- Home-screen widgets: Now playing with play controls, a playlist of your choice to play or shuffle, and the covers of your most played albums; with or without a background
Settings
- Backup and restore of settings, playlists, equalizer presets and remembered devices to a file you choose, also offered on the first start
- Language: English or Polish, independent of the system language
- What’s new, the license and the open-source licenses, readable offline
Requirements
- Android 14 (API level 34) or higher
- Music files in a folder on the device or on an SD card
Building
git clone https://git.hnet.sh/hkr/music.git
cd music
./gradlew assembleDebug
Set the Android SDK path in local.properties (sdk.dir=…) first. Unit tests run with ./gradlew test.
Tech stack
- Language: Kotlin
- Min SDK: Android 14 (API 34), target SDK: API 37
- UI: Jetpack Compose with Material 3 Expressive
- Playback: Media3 ExoPlayer with a media session service
- Data: Room, DataStore; files through the Storage Access Framework
- Tags: Its own parser for FLAC, Ogg, MP3, MP4 and DSD tags
- Widgets: Classic app widgets (RemoteViews), no extra libraries
- Audio: Its own ReplayGain, equalizer and DSD stages in the player’s audio path; bit-perfect output through Android’s preferred mixer attributes
License
Acknowledgments
- The built-in Audeze iSine 10 equalizer preset comes from measurements by oratory1990, as published by Atrium Audio
- Claude by Anthropic – AI assistant that provided valuable support during the development process, helping with code implementation, architecture decisions, and documentation