Fabio/Auxio
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A simple, rational music player for android
741 commits 14 branches 66 tags 66 MiB
Kotlin 90.7%
Java 6.5%
C++ 2.5%
CMake 0.2%
Find a file
OxygenCobalt e5901fa9e2
playback: use gesture insets in playback layout 
When using gesture navigation, swipe up events might conflict with the
slide up behavior of the playback layout. To fix this, inset the
playback bar based on the gesture insets instead of the system bar
insets.
2022-01-18 19:51:06 -07:00
.github Improve layout responsiveness 2021-02-13 10:20:48 -07:00
app playback: use gesture insets in playback layout 2022-01-18 19:51:06 -07:00
fastlane/metadata/android/en-US docs: update full_description 2021-11-26 10:33:37 -07:00
gradle/wrapper chore: upgrade deps 2021-07-29 09:43:28 -06:00
info style: extend edge-to-edge on all versions 2022-01-15 20:12:23 -07:00
.gitignore Add duration to artist songs 2021-04-27 06:13:14 -06:00
build.gradle deps: upgrade 2021-12-17 14:45:40 -07:00
gradle.properties Improve dialog layouts 2021-03-26 15:24:04 -06:00
gradlew playback: use custom exoplayer 2022-01-09 12:27:18 -07:00
gradlew.bat ui: brighten dark theme 2021-09-01 18:48:02 -06:00
LICENSE Initial commit 2020-08-17 15:35:12 +00:00
prebuild.py deps: upgrade deps 2022-01-17 16:49:20 -07:00
README.md style: extend edge-to-edge on all versions 2022-01-15 20:12:23 -07:00
settings.gradle playback: use custom exoplayer 2022-01-09 12:27:18 -07:00

README.md

Auxio

A simple, rational music player for android.

GitHub release Minimum SDK

FAQ | Licenses | Contributing | Architecture

About

Auxio is a local music player with a fast, reliable UI/UX without the many useless features present in other music players. Built off of Exoplayer, Auxio has a much better listening experience compared to other apps that use the native MediaPlayer API. In short, It plays music.

I primarily built Auxio for myself, but you can use it too, I guess.

This branch is the development version of the repository. For a stable version, see the master branch.

Screenshots

Features

  • ExoPlayer based playback
  • Customizable UI & Behavior
  • Genres/Artists/Albums/Songs indexing
  • Reliable playback state persistence
  • ReplayGain support (On MP3, FLAC, OGG, and OPUS)
  • Material You (Android 12+ only)
  • Edge-to-edge
  • Embedded covers support
  • Search Functionality
  • Audio/Headset focus
  • Completely private and offline
  • No rounded album covers

To possibly come in the future:

  • Playlists
  • Liked songs
  • More notification actions
  • And other things, probably

Permissions

  • Storage (READ_EXTERNAL_STORAGE): to read and play your media files
  • Services (FOREGROUND_SERVICE, WAKE_LOCK): to keep the music playing even if the app itself is in background

Building

Auxio relies on a custom version of ExoPlayer that enables some extra features. So, the build process is as follows:

  1. Enter into the project directory
  2. Run python3 prebuild.py, which installs ExoPlayer and it's extensions.
  3. Build the project normally in Android Studio.

Contributing

Auxio accepts most contributions as long as they follow the Contribution Guidelines.

However, feature additions and major UI changes are less likely to be accepted. See Accepted Additions for more information.

License

GNU GPLv3 Image

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 as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.