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-10 00:38:37 +01:00
app Stopped skipping round and round when no file in the queue plays, and kept Clear queue's Undo from mixing the old queue into one played since. Releasing v0.1.0. 2026-11-10 00:38:37 +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 Enabled R8 for release builds, keeping stored enum names, and updated the 0.1.0 release notes. 2026-11-10 00:30:48 +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 Added a README and the F-Droid store metadata in English and Polish, with folders and screenshots. 2026-11-09 23:20:22 +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 that plays the music you keep on your phone.

Current version: v0.1.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 and hi-res 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 handled
  • 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
  • ReplayGain: Track, album or automatic, with a pre-amp for files without tags and clipping prevention
  • Queue: Reorder, remove with Undo, save as a playlist; shuffle and repeat that the queue shows as they play; the queue is kept across restarts
  • Now playing: Cover, technical details of the file, seek bar, volume and the track's tags

Playlists

  • Your own playlists and Starred, kept in the app
  • Import and export of M3U, M3U8, PLS and XSPF; tracks that can't be found stay in place and come back when they turn up

Settings

  • Backup and restore of settings and playlists to a file you choose, also offered on the first start
  • Language: English or Polish, independent of the system
  • What's new, the license and the open-source licences, 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 and MP4 tags

License

GPL-3.0

Acknowledgments

  • Claude by Anthropic – AI assistant that provided valuable support during the development process, helping with code implementation, architecture decisions, and documentation