
Auxio
A sensible and customizable music player for android.
## About
Auxio is a local music player for android partially inspired by both Spotify and other FOSS music players such as [Music Player GO](https://github.com/enricocid/Music-Player-GO) and [Phonograph](https://github.com/kabouzeid/Phonograph), albeit with a heavy emphasis on a simple and straightfoward, however customizable UI/UX.
Unlike other music players, Auxio is based off of [ExoPlayer](https://exoplayer.dev/), allowing for much better listening experience compared to the native [MediaPlayer](https://developer.android.com/guide/topics/media/mediaplayer) API. Auxio's codebase is also designed to be extendable, allowing for the addition of features that are not included in the main app.
I primarily built Auxio for myself, but you can use it too, I guess.
## Screenshots
[
](assets/shot_library_port.png)
[
](assets/shot_playback_port.png)
[
](assets/shot_songs_port.png)
[
](assets/shot_search_port.png)
[
](assets/shot_album_port.png)
[
](assets/shot_artist_port.png)
[
](assets/shot_queue_port.png)
[
](assets/shot_notif.png)
[
](assets/shot_settings_port.png)
[
](assets/shot_genre_port.png)
## Features
- Reliable, [ExoPlayer](https://exoplayer.dev/) based playback
- Customizable UI & Behavior
- Genres/Artists/Albums/Songs support
- Extensive queue system
- Full playback persistence system
- Edge-to-edge (Oreo+ Only)
- Embedded covers support
- Search Functionality
- Audio Focus / Headset Management
- No internet connectivity whatsoever
- Kotlin from the ground-up
- Modular, feature-based architecture
- No rounded corners
## To Come in the future:
- Improved genre/artist/album UIs
- Dedicated search tab
- Swipe-to-next-track function
- Artist Images
- Black theme
- Custom accents
- Playlists
- Liked songs
- More notification actions
- Better edge-to-edge support
- More customization options
- Other things, presumably
## Contributing
Auxio accepts most contributions as long as they follow the [Contribution Guidelines](/.github/CONTRIBUTING.md).
However, feature additions and Major UI changes are less likely to be accepted. See [Accepted Additions](/info/ADDITIONS.md) for more information.
## License
[](http://www.gnu.org/licenses/gpl-3.0.en.html)
Auxio is Free Software: You can use, study share and improve it at your
will. Specifically you can redistribute and/or modify it under the terms of the
[GNU General Public License](https://www.gnu.org/licenses/gpl.html) as
published by the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.