explaingit

oxygencobalt/auxio

3,795KotlinAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

Auxio is a free, open-source local music player for Android that plays audio files from your device, no internet connection, no account, no ads, with gapless playback and strong metadata support.

Mindmap

mindmap
  root((Auxio))
    What it does
      Play local audio files
      Gapless playback
      ReplayGain volume control
    Features
      Embedded cover art
      Multi-artist support
      Android Auto support
      Playlist management
    Privacy
      No tracking
      No ads
      No cloud sync
    Distribution
      F-Droid
      Accrescent
      GPL v3
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Replace a streaming app with a private local music player that plays audio files stored on your Android phone or SD card.

USE CASE 2

Listen to your music library with consistent volume across albums using ReplayGain normalization.

USE CASE 3

Play local music through Android Auto in your car without needing a streaming subscription.

Tech stack

KotlinAndroidExoPlayer

Getting it running

Difficulty · easy Time to first run · 5min

Building from source requires a Unix-based system because a dependency uses shell scripts during compilation.

GNU GPL v3, you can use, share, and modify this software, but any version you distribute must also be open source under the same license.

In plain English

Auxio is a local music player for Android that focuses on doing the basic job well rather than accumulating features. It plays audio files stored on your device without requiring an internet connection, a subscription, or an account. The project is free and open-source, available through F-Droid and Accrescent for users who prefer app stores outside of Google Play. The app is built on top of modern Android media libraries, which the developer says gives it better support for a wide range of audio formats and metadata compared to apps using older Android playback APIs. It handles details like gapless playback between tracks, ReplayGain volume normalization for consistent listening levels across albums, and reading embedded cover art from your audio files. On the metadata side, Auxio supports disc numbers, multiple artists per track, release type information, and sort tags, handling more of the edge cases that simpler players ignore. There is also a folder management system that accounts for music stored on SD cards, playlist support, playback state persistence (so it remembers where you were when you reopen the app), and Android Auto support for use in a car. The design is intentionally opinionated. The developer describes the goal as prioritizing ease of use over supporting every possible edge case, and the contribution guidelines note that feature additions and large UI changes are less likely to be accepted than bug fixes. The app is private by default: no tracking, no cloud sync, no ads. Auxio is licensed under the GNU GPL v3. Building from source requires a Unix-based system because the custom media library it depends on uses shell scripts during compilation.

Copy-paste prompts

Prompt 1
How do I install Auxio from F-Droid on my Android device and point it at my local music folder?
Prompt 2
I want to build a local music player app for Android like Auxio. How does it implement gapless playback between tracks?
Prompt 3
How does Auxio apply ReplayGain to normalize volume across different albums during playback?
Open on GitHub → Explain another repo

← oxygencobalt on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.