A private, offline music player for Android with DSD, bit-perfect USB output and a parametric equalizer.
  • Kotlin 96.7%
  • HTML 3.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-11 00:43:25 +01:00
app Releasing v0.2.0. 2026-11-11 00:43:25 +01:00
gradle Added backup and restore of settings and playlists, and a first-run wizard that adds a music folder or restores a backup. 2026-11-09 15:18:12 +01:00
metadata Releasing v0.2.0. 2026-11-11 00:43:25 +01:00
.gitignore Added .gitignore. 2026-11-07 23:01:19 +01:00
build.gradle.kts Added the app shell with Library, Search and Settings destinations, and moved folder management to Settings › Library with per-folder scan progress, lost-access recovery, skipped files and nested-folder handling (S1). 2026-11-08 20:58:31 +01:00
gradle.properties Added the Settings v2 structure with Language, Reset, and a ComfyChair-style About with What's new and License pages. 2026-11-09 14:07:20 +01:00
gradlew Added the project skeleton: Compose with M3 Expressive, Media3 playback service, Room 3 and SAF folder access without storage or network permissions. 2026-11-08 18:59:10 +01:00
gradlew.bat Added the project skeleton: Compose with M3 Expressive, Media3 playback service, Room 3 and SAF folder access without storage or network permissions. 2026-11-08 18:59:10 +01:00
LICENSE Added LICENSE file. 2026-11-09 12:41:55 +01:00
README.md Releasing v0.2.0. 2026-11-11 00:43:25 +01:00
settings.gradle.kts Added the project skeleton: Compose with M3 Expressive, Media3 playback service, Room 3 and SAF folder access without storage or network permissions. 2026-11-08 18:59:10 +01:00

Music

A private, offline music player for Android with DSD, bit-perfect USB output and a parametric equalizer.

Current version: v0.2.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

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)
  • Bit-perfect output: With a USB DAC, the audio goes out unchanged at each file’s own sample rate, bypassing the system mixer; 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

Settings

  • Backup and restore of settings, playlists and equalizer presets 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
  • Audio: Its own ReplayGain, equalizer and DSD stages in the player’s audio path; bit-perfect output through Android’s preferred mixer attributes

License

GPL-3.0

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