Auxio - A simple, rational music player for android.

Last update: Jan 2, 2023

Overview

Auxio

A simple, rational music player for android.

FAQ / Formats / Licenses / Contributing

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.

Note: Auxio is in a point that I am largely satisfied with. The app is still maintained, but feature additions will be slow.

Screenshots

Features

ExoPlayer 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 possibly come in the future:

Artist Images
Custom accents
Playlists
Liked songs
More notification actions

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

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.

Comments

Multi-artist support

Describe the bug/crash:

When an audio file contains two values on the 'artist' field, only one value is taken.

If another file has this tag, ~it appears as if the first tag detected between each file is the one considered for any following files that contain this tag.~ The first tag alphabetically seems to be the one considered.

Expected behavior

Present all artist values in the 'Artist' view, and on each track. Currently only one of the artists is present in the Artist view, and in the track credit only the first artist (alphabetically) is considered.

(Some music players might opt to concatenate them all instead. This would also be acceptable, though it would clutter the list.)

Steps To Reproduce the bug/crash:

Please see file attached and extract on a phone running Auxio. multipleartist_test.zip Examine the "Artists" view; There should be two artists, and yet there's only one. (Opus files and Ogg files return the same problem.)

Phone Information:

Xiaomi Redmi Note 7, running ArrowOS 12.1 Vanilla.
enhancement rework music complex

opened by animaldaydream 70
Music loading issues
The android media APIs are dying a slow, painful death. This is a super-issue to document the myriad of unfixable issues that have been encountered with media files in Auxio.

These are the issues I am aware of.

Genre indexing is slow and inefficient

Poor ID3v2.4 support [No dates, weird artists]

Poor FLAC support [No dates]

Literally any UTF-8 tag with non-ASCII characters will look corrupted

An uncountable amount of OEM-specific insanity that I can't even include

None of these are fixable because either it's google's job, and they could not care less. What I'm very likely going to do is add SoundPod support and focus most development on that instead of the sinking ship that is the android filesystem.
megathread music
opened by OxygenCobalt 42
Add support for Replaygain
Describe the feature you want to implement:

A toggle for enabling replaygain

Is your feature request related to a problem? Please describe:

Yes, replaygain solves the problem of different tracks sometimes being different levels of volume, and it normalizes the volume.

Sometimes tracks in an album can be different levels of volume, or tracks in a playlist.

Why do you think this will improve everyone's usage of Auxio?

For users who have their music with replaygain tags, definitely. Many users on Android who store their music locally use Replaygain.

Due Diligence:

[ X] I have read Accepted Additions and Requests and the Contribution Guidelines.

enhancement
opened by h4xor666 42
UI/UX changes
This issue is a megathread for general UI/UX changes that I'm working on regarding Auxio.

Feel free to request things, but keep in mind the following:

All rules from the Addition Guidelines apply here.

Some things might not be feasible due to limitations with the android framework, such as:

Swipe gestures not from the playback menu [Navigation restrictions]

Swipe-to-queue [Too many conflicting touch events]

megathread
opened by OxygenCobalt 36
Extended queue UI
note: these are just things that would be cool to have, but i understand if you don't want to implement them, as they solve small or potentially nonexistent problems.

Is your feature request related to a problem? Please describe:

problem:

the queue view is slighly confusing at the moment

it doesen't show songs that were played/full queue if repeat queue is on.

the queue button is hard to reach on tall devices (i have samsung galaxy m21)

Describe the feature you want to implement:

the queue view is slighly confusing at the moment:

the first thing is a small suggestion: show the currently playling song in the top of the queue. This confused me at first when i thought the song i was playing was somehow not in the queue i set to play. something like this (the top, not the actual playing song in the queue) (screenshot from oto music):

it doesen't show songs that were played/full queue if repeat queue is on.

queue doesen't show full "queue" i set to play when loop queue is on. this is kinda bad ux because if you're near to end, and wanna switch a song from the currently playling queue, you can't really do so untill the queue is restarted.
this could be remedied by 2 ways:

have the queue work something like in phonograph, where it shows also already played songs. (and shows -1, -2, etc) (potentially bad ux, not a too big of a fan of this one.)

add the entries at the end of the queue after played (could be pretty confusing). this could be good if the queue items where separated from the currently playling ones by a horizontal separator/text and or grayed out (the text could be "next loop" or something)

have an extra view/button for the full "queue" (not a big fan of this one but it could work)

the queue button is hard to reach:

move the queue button to the bottom: i know you said you didn't have companions for it, but you could add a sleep timer and favorite button there (i am not sure if these are implemented yet, just an idea)

swipe from bottom opens queue. just like swipe from top hides playback view and returns to whatever was before, swipe from bottom would opent he queue drawer.

Why do you think this will improve everyone's usage of Auxio?

the queue view will make more sense

you can more easily pick a song from the currenlty playing subset of songs without haveing to unintuitively skip to restart the queue

it takes less time and uncomfortable finger movement to open the queue on a tall phone

Due Diligence:

[x] I have read the Contribution Guidelines.

[x] I have read the Accepted Additions and Requests document.

[x] I have checked for this feature in the FAQ.

enhancement ui
opened by KraXen72 34
Small widget has only one button
Describe the feature you want to implement:

small widget only has one button: . this is pretty limiting. i think atleast a forward and back buttons would fit, like in the notification:

Is your feature request related to a problem? Please describe:

small widget is annoying to use

Do other music players handle this? If so, how?

Oto music(sorry for big screenshot):

Why do you think this will improve everyone's usage of Auxio?

ease of use/ux

Due Diligence:

[x] I have read the Contribution Guidelines.

[x] I have read the Accepted Additions and Requests document.

[x] I have checked for this feature in the FAQ.

enhancement
opened by KraXen72 32
Smarter management of artists metadata tags
Describe the feature you want to implement:

Some artists have their names stylized differently depending on the release. They also happen to have collaboration with other artists.

In Auxio, this create a separate artist entry for each of those situations.

I wish to have all those under the same artist tab to declutter the artist tab and find the records in a more convenient manner.

So when I open the artist tab i have all the artist's releases including collaboration and single releases. For example here I have the artist exael, sometimes stylized as 'EXAEL', 'Exael' or when it's a collaboration it's 'foo & bar' 'foo + bar' 'foo, bar', 'foo/bar', etc... Right now, Auxio makes a separate entry for each of those

Here is how Odyssey deals with it. I have opened the single exael artist tab. And all the releases are gathered together, doesn't matter how exael is stylized or of it is a single release or a collab.

Is your feature request related to a problem? Please describe:

When i browse through an artist albums i have to go back and forth to see other releases. I may miss releases because they are all separated.

Why do you think this will improve everyone's usage of Auxio?

The collaboration thing is prevalent in electronic, experimental, jazz, hip-hop... It may seems specific but I believe it is rather common and not an edge case if having this kind of records. Overall i find this tag management more elegant and intuitive.

Due Diligence:

[x] I have read Accepted Additions and Requests and the Contribution Guidelines.

enhancement
opened by foldfree 31
Current Song is not always updated properly in Media Notification
Describe the bug/crash:

I have noticed that on my device the currently played song is not updated correctly in the media notification all the time. Every few songs, the song displayed in den media notification does not update when I skip to the next song. I tried debugging the issue for some time, but could not quite figure out where it might be coming from. However, what I noticed is that if I just call target.onCompleted(null) in the BitmapProvider.load() call and return after, the issue did not present itself (there was however no cover shown for obvious reasons).

The issue was already present when I started using the app with version 2.3.1 and it persists in 2.4.0 and current dev branch. As I have seen that you reworked the bitmap loading in 4a79de455a9f2f35caa2e9dd3e52929dc3333df3, I also tried e785f5a3a5a8641646e036621ea34b5fa3123c40, but the issue was present here as well.

Expected behavior

Currently played song should correspond to the song shown in the notification.

Steps To Reproduce the bug/crash:

Play music.

Skip until the song is not updated properly.

Logs/Stack Traces:

--

Screenshots:

--

Phone Information:

Pixel 4a running Android 12 Pixel 4a Emulator running Android 12

(On the Pixel 4a Emulator running Android 11 the problem did not seem to be present)

Due Diligence:

[x] I have checked this issue for any duplicates.

[x] I have checked for this issue in the FAQ.

[x] I have read the Contribution Guidelines.

bug device-specific
opened by jpohlmeyer 27
Skipping in the UI crashes the app
Describe the bug/crash:

App crashes when skipping fast/sometimes skipping at all

Expected behavior

app doesn't crash

Steps To Reproduce the bug/crash:

i know this sounds like a nightmare to reproduce, but sometimes, when i skip too fast or at all, the app crashes. it happened on some particular songs more than once, but now it's happening with other songs occasionally as well.

the crash occurs right after a skip, the new song does not start playing, nor does the album art load.

it happened like 3 times today and I've used auxio for maybe 2-3 hours (mostly background play, crash only occurs while in foreground)

also sometimes it happens a few times in a short span of time (30s). i reopen to skip and it crashes again

Logs/Stack Traces:

none

Screenshots:

couldn't capture

Phone Information:

samsung galaxy m21

android 12 oneui 4.2

niagara launcher

Due Diligence:

[x] I have checked this issue for any duplicates.

[x] I have checked for this issue in the FAQ.

[x] I have read the Contribution Guidelines.

bug
opened by KraXen72 22
Version 3.0.0

Version 3.0.0 of Auxio.

Test APK: Auxio_3.0.0.zip

@Kraxen72 @foss- @alanorth @illdeletethis Care to test this before I merge? I want to start making a habit out of having a preliminary testing period like NewPipe so I can avoid really bad issues from working their way into the release.

opened by OxygenCobalt 19
Sorting by date added

Please add an option to sort the songs as per the date that is added it's very important as we like to listen to the songs that are added recently. It's important for user experience
enhancement music

opened by arunava-nandy 17
New release notification & "Check update" button
Description

With the latest releases I noticed that there was no feature in Auxio that allow the user to directly update the application / download the latest APK. There is also no notification system to warn users that a new version of Auxio is available.

It would be nice to implement such a feature in the "About" section or to show a New Release notification when starting Auxio.

Problem solved

I don't think it's instinctive for everyone to go to the GitHub repository to check for updates. And, for example, if a vulnerability is fixed with a release, all users should be aware that a patch is available as soon as possible.

Other implementations

I don't know how open source music players are doing this, but if you take the example of Neko, a manga reader, there is in "About" section a button to update the app. And the application informs users of the latest releases with a pop-up when it opens.

Benefit

In this way, anyone using Auxio will be guaranteed to have their application up to date, with the latest features. Or at least be aware that a new version is available.

Duplicates

[X] I have checked this feature request for duplicates.

[X] I have checked that this feature is not implemented in the lastest version.

[X] I have checked the Why Are These Features Missing? page.

[X] I agree to the Contribution Guidelines.

enhancement
opened by Dyl-M 1
Play selected

Left over from #93 and discussion in #267 and #196. More or less, an option that allows all songs in a user selection to be played or shuffled, without having to play another item like an album and then remove the items you do not want.
enhancement playback

opened by OxygenCobalt 2
Official website

Make an official website for Auxio once the major features like #36 are done. This is largely an excuse to force myself to learn more about website development.
blocked meta

opened by OxygenCobalt 4
Replaygain may stop working after playing a non-replaygain-tagged file
Describe the bug/crash:

~Under the "Songs" tab of media library,~ a replaygain tagged file may sometimes played with original volume (without replaygain applied).

~Seems only can happen when replaygain strategy is set to "Prefer album" or "Prefer album if one is playing", although not always.~

Seems only can happen when the file is played after a non-replaygain-tagged file, or a replaygain-unsupported file (? .m4a here, see #292).

Never saw this happen when the file is played after another replaygain-tagged & supported (.mp3) file.

~Never saw this happen under the "Album" tab.~

Expected behavior

Files should always played with replaygain applied if properly tagged.

Steps To Reproduce the bug/crash:

~1. Settings - Audio - ReplayGain strategy set to "Prefer album" or "Prefer album if one is playing"~ ~2. Switch to "Songs" tab in media library~ 3. Play a non-replaygain-tagged file for a couple of seconds 4. Switch to play a replaygain-tagged file, and there is a good chance that it's played with original volume without replaygain applied.

Phone Information:

Redmi Note 10 Pro (China), MIUI 13.0.11 (based on Android 12)

Due Diligence:

[x] I have checked this issue for any duplicates.

[x] I have checked for this issue in the FAQ.

[x] I have read the Contribution Guidelines.

bug playback
opened by bodayw 15
Unit Testing
After the absolute fiasco that was #273, I've realized that I should really add unit tests to Auxio. I didn't do this before because I initially wrote this app when I had no idea why unit tests were important.

This involves writing a test suite with JUnit (and whatever framework is used for UI code). I think the testing could be sub-divided into:

The music Indexer. This is super easy to test, and what I want to do first.

Shared object system. This is harder to test, and the major shared object bugs (race conditions) will always be impossible to test.

The UI, which is really frustrating to test, and why I never did unit testing originally.

Perhaps I'll do other things alongside this like Continuous Integration.
enhancement rework meta
opened by OxygenCobalt 1

Releases(v3.0.1)

v3.0.1(Jan 4, 2023)
What's New

Added support for album date ranges (ex. 2010 - 2013)

What's Improved

Formalized whitespace handling

Value lists are now properly localized

Queue no longer primarily shows previous songs when opened

Added reset button to ReplayGain pre-amp configuration dialog

What's Fixed

Fixed mangled multi-value ID3v2 tags when UTF-16 is used

Fixed crash when playing certain MP3 files

Detail UI will no longer crash if the music library is unavailable

What's Changed

R128 ReplayGain tags are now only used when playing OPUS files

Dev/Meta

Add CI workflow

APK Checksum (SHA-256): e207b412af2bfe0ae62bda13c1864e90fd60ec40057271309508fc1c04dcc0b4
Source code(tar.gz)
Source code(zip)
Auxio_3.0.1.apk(4.67 MB)
v3.0.0(Dec 30, 2022)
What's New

Added multi-value tags support

Added support for multiple artists

Added support for multiple genres

Artists and album artists are now both given UI entires

Added setting to hide "collaborator" artists

Upgraded music ID management:

Added support for MusicBrainz IDs (MBIDs)

Use a more unique hash of metadata when MBIDs can't be used

Genres now display a list of artists

Added toggle to load non-music (Such as podcasts)

Music loader now caches parsed metadata for faster load times

Redesigned icon

Added animated splash screen on Android 12+

Added support for MP4 ReplayGain (----) atoms

What's Improved

Sorting now takes accented characters into account

Added support for compilation sub-release-types like (DJ) Mix

Album dates now start from the earliest date instead of latest date

Reshuffling the queue will no longer drop any songs you have added/removed

Allowed light/dark theme to be customized on Android 12+

All information now scrolls in the playback view

A month is now shown for song/album dates when available

Added loading indicator to song properties view

List items have been made more compact

What's Fixed

Fixed issue where the scroll popup would not display correctly in landscape mode

Fixed issue where the playback progress would continue in the notification when audio focus was lost

Fixed issue where the artist name would not be shown in the OS audio switcher menu

Fixed issue where the search view would not update if the library changed

Fixed visual bug with transitions in the black theme

Fixed toolbar flickering when fast-scrolling in the home UI

What's Changed

Ignore MediaStore tags is now Auxio's default and unchangeable behavior. The option has been removed

"Use alternate notification action" is now "Custom notification action"

"Show covers" and "Ignore MediaStore covers" have been unified into "Album covers"

Dev/Meta

Created new wiki with more information about app functionality

Switched to issue forms

Completed migration to reactive playback system

Refactor music backends into a unified chain of extractors

Add bluetooth connection receiver (No functionality in app yet)

APK Checksum (SHA-256): e831f5f7cd39ff417b879cf66e11a96cee1604cb699c756655c1b192ade7cf25
Source code(tar.gz)
Source code(zip)
Auxio_3.0.0.apk(4.67 MB)
v2.6.4(Nov 16, 2022)
What's Fixed

Fixed issue where invalid position values would crash the app

Fixed issue where opening the song menu in the genre view would crash the app

APK Checksum (SHA-256): abf6a7e97e46936ca2f44992363e13a386af0e8ec6bb1d8e60c168c729db6529
Source code(tar.gz)
Source code(zip)
Auxio_2.6.4.apk(4.59 MB)
v2.6.3(Sep 3, 2022)
What's New

Improved playing indicators [#218]

Search and library now show playing indicators

Playing indicators are now animated when playback is ongoing

Added smooth seeking [#130]

What's Improved

Moved the "more" button in the playback view back to the top

What's Fixed

Fixed issue where fast scroller popup would not appear

Fixed issue where fast scroller would not correctly show thumb progress in small lists

APK Checksum (SHA-256): 5dd0b398b33a795cbb1dc96db41f6f0def47dbee7499b5dd4dadf17f4bbfd85d
Source code(tar.gz)
Source code(zip)
Auxio_2.6.3.apk(4.58 MB)
v2.6.2(Aug 28, 2022)
What's New

Added Android 13 support [#129]

Switch to new storage permissions

Add themed icon

Fix issue where widget covers would not load

Use new media notification panel style

Add predictive back navigation

Auxio has a new, more refined icon style

Added a way to access the system equalizer from the playback menu

What's Improved

Playback bar now has a marquee effect

Play/pause button now changes from square to circle depending on the state

What's Fixed

Fixed incorrect strings from appearing in dialog buttons

Fixed issue where LG devices would not show metadata in the notification [#219]

Fixed issue where the transition would be wrong when navigating out of the detail views after rotating the device

Fixed issue where widget resizing would be far different than intended

Fixed broken playback layout on small portrait screens

What's Changed

ReplayGain can now no longer be disabled. Remove ReplayGain tags from files if such functionality is not desired

APK Digest (SHA-256): d74c8e52b9f35bf547e88e58dc4ca42c9c2dc70dc055eaeaa3d8f625199e1891
Source code(tar.gz)
Source code(zip)
Auxio_2.6.2.apk(4.56 MB)
v2.6.1(Aug 10, 2022)
What's New

Added basic equalizer support in external apps like Wavelet [#211]

Added option to control the type of action shown on the playback bar [#108]

Detail UI now displays the type of item shown (ex. the release type)

What's Improved

Queue now scrolls to currently playing song instead of the song after it

What's Fixed

Fixed incorrect font being used in the queue title

Fixed missing fast scroll indicator with date added scrolling

What's Changed

Use X-axis transitions instead of Z-axis (Avoids visual clipping)

Queue no longer has rounded corners for consistency

APK Digest (SHA-256): a6d184def8defee5622b1d3861d8a57858f1fb48a290a461c1b2b0dc7ec99e5e
Source code(tar.gz)
Source code(zip)
Auxio_2.6.1.apk(4.64 MB)
v2.6.0(Aug 6, 2022)
What's New

Added option to ignore MediaStore tags, allowing more correct metadata at the cost of longer loading times

Added support for sort tags [#172, dependent on this feature]

Added support for date tags, including more fine-grained dates [#159, dependent on this feature]

Added support for release types signifying EPs, Singles, Compilations, and more [#158, dependent on this feature]

Added basic awareness of multi-value vorbis tags [#197, dependent on this feature]

Heavily improved the main playback UI [#92]

Queue can now be swiped up

Playing song is now shown in queue

Added ability to play songs from queue

Added ability to see previous songs in queue

Added dual-pane view of queue and playback on landscape and tablets

Added Last Added sorting [#181]

Search now takes sort tags and file names in account [#184]

Added option to clear playback state in settings [#107]

What's Improved

Migrated to better-looking motion transitions [#191]

App now exposes an (immutable) queue to the MediaSession [#37]

Improved widget sizing/cover management

What's Fixed

Fixed default material theme being used before app shows up

Fixed shuffle shortcut and file opening not working on startup on some devices

Fixed issue where the notification position would not match if one seeked when paused

Fixed issue where widget could not be sized to it's smallest form

Fixed issue where restored state would override a song if it was played early enough in startup

What's Changed

Play and skip icons are filled again [#187]

Updated music hashing (Will wipe playback state)

Removed unnecessary capitalization

Dev/Meta

Migrated to BottomSheetBehavior [#92]

Source code(tar.gz)
Source code(zip)
Auxio_2.6.0.apk(4.63 MB)
v2.5.0(Jul 13, 2022)
What's New

Massively overhauled how music is loaded [#72]:

Auxio can now reload music without requiring a restart

Added a new option to reload music when device files change

Added a shuffle shortcut

Widgets now have a more sleek and consistent button layout

"Rounded album covers" is now "Round mode"

Added option to customize what occurs when a song is played from an album/artist/genre [#164]

What's Improved

Made "timeline" elements (like playback controls) always left-to-right

Improved performance when ReplayGain is not enabled

What's Fixed

Fixed broken tablet layouts

Fixed seam that would appear on some album covers

Fixed visual issue with the queue opening animation

Fixed miscellaneous startup issues

Fixed crash if settings was navigated away before playback state finished saving

Fixed broken album menu

Fixed crash that would occur when opening a file on some devices [#176]

Fixed issue where the search filter menu would not display the correct mode

Fixed crash when search filter mode was changed

Fixed shuffle button appearing below playback bar on Android 10 and lower

Fixed incorrect song being shown in the notification in some cases [#179]

Fixed issue where toolbar will be clipped on Lollipop devices

Fixed infinite loading if one had no music folders set [#182]

What's Changed

Reworked typography and iconography to be more aligned with material design guidelines

Old excluded directories from 2.3.1 will no longer be migrated

Dev/Meta

Migrated preferences from shared object to utility

Removed 2.0.0 compat code

Updated ExoPlayer to 2.18.0

Reworked sorting to be even more efficient

Source code(tar.gz)
Source code(zip)
Auxio_2.5.0.apk(4.58 MB)
v2.4.0(Jun 16, 2022)
What's New

Excluded directories has been revamped into "Music folders"

Folders on external drives can now be excluded [#134]

Added new "Include" option to restrict indexing to a particular folder [#154]

Added a new view for song properties (Such as Bitrate) [#144]

The playback bar now has a new design, with an improved progress indicator and a skip action

What's Improved

The toolbar in the home UI now collapses when scrolling

The toolbar layout is now consistent with Material Design 3

Genre parsing now handles multiple integer values and cover/remix indicators (May wipe playback state)

"Rounded album covers" option is no longer dependent on "Show album covers" option [#152]

Added song actions to the playback panel

Playback controls are now easier to reach when gesture navigation is enabled

Added Play Next/Add to Queue options to artists and genres

Covers in the detail views now show an indicator when playing

Made dynamic colors the default color scheme on Android 12

What's Fixed

Playback bar now picks the larger inset in case that gesture inset is missing [#149]

Fixed unusable excluded directory UI

Songs with no data (i.e size of 0) are now filtered out

Fixed nonsensical menu items from appearing on songs

Fixed issue where multiple menus would open if long-clicks occured simultaneously

Dev/Meta

New translations [Fjuro -> Czech, Konstantin Tutsch -> German]

Moved music loading to a foreground service [#72]

Phased out ImageButton for MaterialButton

Unified icon sizing

Properly handle volumes throughout the entire music loading process

Added original date support to ExoPlayer parser (Not exposed in app)

Source code(tar.gz)
Source code(zip)
Auxio_2.4.0.apk(4.40 MB)
v2.3.1(Jun 3, 2022)
What's Improved

Loading UI is now more clear and easy-to-use

Made album/artist/genre grouping order consistent (May change genre images)

What's Fixed

Fixed crash when seeking to the end of a track as the track changed to a track with a lower duration

Fixed regression where GadgetBridge media controls would no longer work

Fixed bug where music would be incorrectly reloaded on a hot restart

Fixed issue where the album/artist/genre would not be correctly restored

Fixed issue where items would not highlight properly in the detail UI

Fixed hypothetical issue where widget would cause an OOM on large devices

Dev/Meta

New translations [yurical -> Korean, qwerty287 -> German]

Switched from LiveData to StateFlow

Use notifyItemChanged instead of directly mutating ViewHolder instances.

Added highly experimental ExoPlayer metadata backend (not enabled in-app)

Source code(tar.gz)
Source code(zip)
Auxio_2.3.1.apk(4.36 MB)
v2.3.0(May 26, 2022)
What's New

Added disc number support

Added ReplayGain support for below-reference volume tracks [i.e positive ReplayGain values]

Added ReplayGain pre-amp customization

About screen now shows counts for multiple types of library items, alongside a total duration

New disc, track, song count, and duration sorting modes

What's Improved

Re-enabled theme customization on Android 12

The tab selector now hides itself when there is only one tab

Made the cover on the thin widget larger

What's Fixed

Fixed incorrect ellipsizing on song items

Fixed a variety of esoteric crashes with queue state

Fixed music indexing error when the OS would not provide a file name

Fixed icon corruptions on lollipop devices

What's Changed

Audio focus is no longer configurable

Made the layout of album songs more similar to other songs

Dev/Meta

Updated translations [Konstantin Tutsch -> German, cccClyde -> Chinese, Gsset -> Russian, enricocid -> Italian]

Switched to spotless and ktfmt instead of ktlint

Migrated constants to centralized table

Introduced new RecyclerView framework

Use native ExoPlayer AudioFocus implementation

Make ReplayGain functionality use AudioProcessor instead of volume

Removed databinding [Greatly reduces compile times]

Start using Material You dialogs

An uncountable amount of internal codebase improvements

Source code(tar.gz)
Source code(zip)
Auxio_2.3.0.apk(4.33 MB)
v2.2.2(Mar 8, 2022)
What's New

New spanish translations and metadata [courtesy of n-berenice]

What's Improved

Rounded images are more nuanced

Shuffle and Repeat mode buttons now have more contrast when they are turned on

What's Fixed

Fixed crash on certain devices running Android 10 and lower when a differing theme from the system theme was used [#80]

Fixed music loading failure that would occur when certain paths were parsed [#84]

Fixed incorrect track numbers when the tag was formatted as NN/TT [#88]

Fixed years deliberately set as "0" showing up as "No Date"

Fixed headset management unexpectedly starting audio when the app initially opens

Fixed crash that would occur during a playback restore with specific queue states [#89]

Partially fixed buggy behavior when multiple queue items were dragged in quick succession

What's Changed

All cover art is now cropped to a 1:1 aspect ratio

Headset focus has been replaced with headset autoplay. It can no longer be disabled.

Dev/Meta

Enabled elevation drop shadows below Android P for consistency

Switches now have a disabled state

Reworked dynamic color usage

Reworked logging

Upgrade ExoPlayer to v2.17.0 [Eliminates custom fork]

Source code(tar.gz)
Source code(zip)
Auxio_2.2.2.apk(4.38 MB)
v2.2.1(Feb 19, 2022)
What's Improved

Updated chinese translations [courtesy of cccClyde]

Use proper material you top app bars

Use body typography in correct places

Expose file opening functionality better [#78]

What's Fixed

Fixed issue where playback would start unexpectedly when opening the app

What's Changed

Disabled audio focus customization on Android 12 [#75]

Source code(tar.gz)
Source code(zip)
Auxio_2.2.1.apk(4.38 MB)
v2.2.0(Feb 7, 2022)
What's New:

Added Arabic translations [Courtesy of hasanpasha]

Improved Russian translations [Courtesy of lisiczka43]

Added option to reload the music library

What's Improved:

Songs now show their specific artist name instead of the name of the artist they are grouped up in

Artists are now grouped up case-insensitively

Songs of different file formats are now grouped up into a single album

Reworked typography slightly

Invalid track numbers [i.e 0] will now be shown as a generic song icon

What's Fixed:

Fixed crash on some devices configured to use French or Czech translations

Malformed indices should now be corrected when the playback state is restored

Fixed issue where track numbers would not be shown in the native language's numeric format

Fixed issue where the preference view would apply the M3 switches inconsistently

Fixed issue where the now playing indicator on the playback screen would use an internal name

Dev/Meta:

Removed 1.4.X compat

Added new changelog document

Reworked contribution info and templates

Source code(tar.gz)
Source code(zip)
Auxio_2.2.0.apk(4.38 MB)
v2.1.0(Jan 29, 2022)
What's New:

Switched to a single queue system [i.e Play Next/Add to queue]

Added ReplayGain support [Experimental]

New russian translations [Courtesy of Vladimir Kosolapov]

New chinese translations [Courtesy of cccClyde]

Android 12L support

Added option to round album covers for visual cohesion

Added FLAC support for devices on Android Oreo and lower

Added edge-to-edge support on devices on Android Oreo and lower

What's Improved:

Increased mosaic quality

Enabled black theme on Android 12+

Content now fades when the playback view is expanding

Improved layouts on small and large screens

Improved how the app handles audio focus

Improved how invalid years and durations are handled

Use Material 3 switches in the settings menu

What's Fixed:

Fixed issue where the playback view would be hard to swipe up to when using gesture navigation

Band-aided completely broken layouts in split screen mode

Fixed crash in the playback view when a song's duration was 0

Fixed issue where apps like GadgetBridge would not detect Auxio

Dev/Meta:

ExoPlayer is now a local dependency

Added ExoPlayer metadata support for Ogg Vorbis and Opus

Source code(tar.gz)
Source code(zip)
Auxio_2.1.0.apk(4.30 MB)
v2.0.1(Nov 26, 2021)
This is a hotfix. Please see the 2.0.0 changelog for the full list of changes.

What's Fixed:

Fixed problem where the compact playback controls would not work

Fixed unusable playback layout on small screens

Source code(tar.gz)
Source code(zip)
Auxio_2.0.1.apk(3.67 MB)
v2.0.0(Nov 26, 2021)
What's New:

Auxio has a new look derived from Material 3

Material You support on Android 12

Library and song view have been merged into a unified view

Shuffle can now be accessed everywhere

Media indexer now supports album artists

Accents are now more vibrant and varied

One can now slide up the compact playback view to reveal the full playback view

Redesigned widgets to respect album art and increase visual cohesion

Added song sorting [#16]

Added default tab customization [#12]

Added album, artist, and year sorting options

Added descending order to all sorting options

Added czech translations [Courtesy of Fjuro]

Fast scroller has been replaced with a scrollbar with fast scroll capabilities

What's Improved:

Improved playback persistence [State will be wiped]

Improved accessibility everywhere

Streamlined the search UI

Improved queue UI

Improved detail UI

Unified appbar behavior

Songs with accented characters will now show up in search when using their non-accented counterparts

Removed loading screen

Artist/Genre images now respect the "Ignore MediaStore Covers" setting

Ascending order now works properly with years

Fixed poor UI on Lollipop devices

What's Fixed:

Switched to a new play icon [Fixes seam/alignment issues]

Fixed issue where notifications would not be colored on samsung phones

Re-added the german translations that were accidentally removed in 1.4.2

Fixed issue where links could not be opened on Android 11+

Fix crash that would occur when rotating the dialog

Fixed issue where cover art could not be loaded at all on some devices [#51]

Fixed issue where widgets would have unusable UIs on certain device configurations

Fixed issue where older launchers will not show a widget preview on android 12

Fixed duplicate songs appearing on some devices

What's Changed:

Removed colorize notification option

Removed deep orange and blue grey accents

Dev/Meta:

Migrated to material entirely

Reworked UI dimensions to line up with material design

Use color selectors in more places

Eliminated legacy size classifiers

Created new architecture document

Source code(tar.gz)
Source code(zip)
Auxio_2.0.0.apk(3.67 MB)
v1.4.2(Aug 21, 2021)
What's New:

Added Widgets

Android 12 support

What's Improved:

Fast scroller now truncates more aggressively when there is not enough space

Minor improvements to layout hierarchy

Detail text/track numbers will no longer shrink

Loading screen has been tweaked to line up with the rest of Auxio

What's Fixed:

Fixed issue where the new about screen would be cut off in landscape mode

Fixed issue where songs from two albums with the same year would be incorrectly shown in the artist view

Dev/Meta:

Added license boilerplate

Source code(tar.gz)
Source code(zip)
Auxio_1.4.2.apk(3.43 MB)
v1.4.1(Jul 29, 2021)
What's New:

Added black dark theme

Added a fast-scroller to the library view

Redesigned the about screen

Added full spanish translations [Courtesy of tesphil]

Added an option to pause when a song repeats [#29]

What's Improved:

Article sort is now used everywhere

Improved german translations [Courtesy of qwerty287]

What's Fixed:

Fixed problem where cover art would disappear on the lock screen

Fixed problem where playback controls would not work on the lock screen [#20]

Fixed issue where fast-scroller indicators would not line up for titles starting with "An"

Dev/Meta:

Updated ExoPlayer to 2.14.2

Completely refactored UI styling

Added permission documentation [#22]

Removed the ACCESS_NETWORK_STATE permission [#22]

Added icon to metadata [#25]

Source code(tar.gz)
Source code(zip)
Auxio_1.4.1.apk(3.39 MB)
v1.4.0(May 9, 2021)
What's New

Artist view now shows a list of songs

Loop functionality now has a new, more sensible behavior

Dialogs have been revamped with a new style

Added complete dutch translation [Courtesy of timnea]

What's Improved

Changed the header font to be cleaner

Completely rolled custom dialog system

Blacklisted directories are now chosen through the built-in file picker

Improved opening links in the about dialog

Restore system now uses unique identifiers, increasing reliability and speed [Will wipe previous state]

Grey accent in dark mode has been made more visible

The queue will now reflect the current album/artist/genre sort

Album/artist/genre sort is now remembered when the app restarts

What's Fixed

Fixed issue where the scroll thumb would briefly display on the Songs UI

Fixed issue where fast scrolling could be triggered outside the bounds of the indicators

Fixed issue where the wrong playing item would be highlighted if the names were identical

Fixed a crash when the thumb was moved above the fast scroller [Backported to 1.3.3, included in this release officially]

Dev/Meta

Migrated fully to material design

Int preferences are now used everywhere

Upgraded ExoPlayer to 2.13.3

Eliminated dependence on JCenter

Eliminated Material Dialogs and Browser dependencies

Source code(tar.gz)
Source code(zip)
Auxio_1.4.0.apk(3.39 MB)
v1.3.3(Mar 24, 2021)
What's Fixed

Fixed crash that would occur when the app would shut down, preventing the playback state from being saved

Dev/Meta

Explicitly declared dependencies

Completely integrated fast-scroller code into codebase

Source code(tar.gz)
Source code(zip)
Auxio_1.3.3.apk(3.73 MB)
v1.3.2(Mar 22, 2021)
What's New

Added the ability to exclude directories from indexing [#6]

Accents have been redone to improve visibility and UI simplicity

Enabled wake lock functionality

What's Improved

Queue UI no longer navigates away when playing from a file

Songs UI no longer keeps scroll momentum when fast scrolling

Improved handling of old genre names

Changed the header font to be cleaner

Improved mosaic quality

What's Fixed

Fixed issue where prominent genre would display incorrectly on artist view

Fixed issue where AudioFocus would begin playback spontaneously

Fixed issue where AudioFocus would not restore volume to 100% after ducking

Fixed issue where the last item in the queue would be behind the navigation bar in edge-to-edge mode

Fixed issues with the playback restore process (Current state will be wiped on update)

Fixed buggy behavior when shuffle is toggled inside queue UI

Dev/Meta

Updated exoplayer to 2.13.2

Updated navigation to 2.3.4

Source code(tar.gz)
Source code(zip)
Auxio_1.3.2.apk(3.74 MB)
v1.3.1(Feb 21, 2021)
What's New

Added the ability to play a song from a file

Added ability to manually save the playback state

What's Improved

Optimized icons

Updated the animation of the compact controls to be faster

Songs without genres are now placed into an unknown genre

What's Fixed

Fixed issue where the music load would fail from repeated genre applications [#4]

Fixed crash that would occur on the songs UI due to bad music loading [#5]

Dev/Meta

New tagline and description

Rewrote loading UI

Rewrote notification code

Source code(tar.gz)
Source code(zip)
Auxio_1.3.1.apk(3.62 MB)
v1.3.0(Feb 17, 2021)
Whats New:

Added west-european translations [German, Spanish, French, Italian, Dutch, Portugese]

Added east-european translations [Romanian, Greek, Russian, Ukranian, Polish, Hungarian]

Added asian translations [Hindi, Indonesian, Chinese, Korean]

Added middle-eastern translations [Turkish]

Whats Improved:

Optimized image loading even further

Improved the UI on smaller tablets

Updated the playback UIs to look better on all devices

Improved the look of the play/pause button

Compact controls slide up instead of fade in

Whats Fixed:

Fixed RTL layout issues

Fixed elevation problems on the compact controls

Fixed issue where a seam would show up on the play icon on certain displays

Fixed issue where you could still collapse the toolbar on the search view with no results

Fixed issue where an album would not show up as playing if played from the artist UI

Dev/Meta:

Added fastlane metadata

Updated Exoplayer to 2.12.3

Updated Coil to 1.1.1

Updated support libraries to 1.3.0

Added architecture document

Simplified themes

Source code(tar.gz)
Source code(zip)
Auxio_1.3.0.apk(3.62 MB)
v1.2.0(Jan 20, 2021)
Whats New

The detail UIs have been redesigned to show the Play and Shuffle options front-and-center

The Toolbars on the detail UIs have been made more visually appealing

Images on the detail UIs now have a shadow applied to them

Albums now have a "Go to artist" option in their menu

Navigation has been made much for fluid and straightforward

Search has been moved to a dedicated tab

Added option to filter searches by Song, Album, Artist, and Genre

Whats Improved

The sorting menu is now a dedicated menu instead of an overflow menu, improving accessibility

Disk-Caching with Coil is now completely turned off

Tablet layouts have been made more visually appealing

Made the icons in the Playback UI look better

Queues are now properly sorted when not shuffled

Whats Fixed

Fixed issue where audio focus would resume after an interruption even if explicitly paused by the user

Fixed a crash that would occur when a song with no genre was played from its genre

Fixed a crash that would occur from the settings being accessed before they were created

Fixed an issue where the keyboard will stay visible when navigating to something

Fixed multiple memory leaks

Fixed problem where the fast scroll indicator on the Songs UI would be slightly off

Fixed issue where rewinding wouldn't cause the playback to start again

Fixed problem where the artist play action wouldn't work

Whats Changed

"Remember Shuffle" is now on by default

Source code(tar.gz)
Source code(zip)
Auxio_1.2.0.apk(3.58 MB)
v1.1.0(Jan 2, 2021)
Whats New

Rewrote the music loading system to be much faster

Genres are now song-based instead of artist-based

When an album is being played, that album will be highlighted in the artist UI

If a song is playing from a genre, that song will be highlighted in the genre UI

Switched to a new audio focus system that allows for volume reduction & auto-resuming

Added option not to load cover art

Added option to ignore MediaStore cover art

Added option to play a song from its genre

Whats Improved

Made Genre/Artist/Album UIs more efficient

Playback state restores are now more reliable if the music library changes

Optimized ExoPlayer for audio playback

Landscape support is now better for phones/tablets

Optimized how Coil is used

Items are now shown in two columns instead of three when a phone is in landscape

Whats Fixed

Stop the play/pause button from animating on the Now Playing screen

Stopped coil from increasing the app size over time due to needless disk caching

Enabled constant bitrate seeking, allowing for AAC/certain MP3s to be seekable

Whats Changed

Rewind threshold option has been removed

"Play from artist", "Play from album", and "Play from All Songs" have been removed from the song menu in favor of "Go to artist" and "Go to album"

The currently playing song on the Album UI will now only show if the song is actually playing from the album

Source code(tar.gz)
Source code(zip)
Auxio_1.1.0.apk(3.57 MB)
v1.0.0(Dec 20, 2020)

Initial Release.
Source code(tar.gz)
Source code(zip)
Auxio_1.0.0.apk(3.63 MB)

Auxio - A simple, rational music player for android.

Related tags

Overview

Auxio

A simple, rational music player for android.

FAQ / Formats / Licenses / Contributing

About

Note: Auxio is in a point that I am largely satisfied with. The app is still maintained, but feature additions will be slow.

Screenshots

Features

To possibly come in the future:

Contributing

License

Comments

Describe the bug/crash:

Expected behavior

Steps To Reproduce the bug/crash:

Phone Information:

Describe the feature you want to implement:

Is your feature request related to a problem? Please describe:

Why do you think this will improve everyone's usage of Auxio?

Due Diligence:

Is your feature request related to a problem? Please describe:

Describe the feature you want to implement:

Why do you think this will improve everyone's usage of Auxio?

Due Diligence:

Describe the feature you want to implement:

Is your feature request related to a problem? Please describe:

Do other music players handle this? If so, how?

Why do you think this will improve everyone's usage of Auxio?

Due Diligence:

Describe the feature you want to implement:

Is your feature request related to a problem? Please describe:

Why do you think this will improve everyone's usage of Auxio?

Due Diligence:

Describe the bug/crash:

Expected behavior

Steps To Reproduce the bug/crash:

Logs/Stack Traces:

Screenshots:

Phone Information:

Due Diligence:

Describe the bug/crash:

Expected behavior

Steps To Reproduce the bug/crash:

Logs/Stack Traces:

Screenshots:

Phone Information:

Due Diligence:

Description

Problem solved

Other implementations

Benefit

Duplicates

Describe the bug/crash:

Expected behavior

Steps To Reproduce the bug/crash:

Phone Information:

Due Diligence:

Releases(v3.0.1)

v3.0.1(Jan 4, 2023)

What's New

What's Improved

What's Fixed

What's Changed

Dev/Meta

v3.0.0(Dec 30, 2022)

What's New

What's Improved

What's Fixed

What's Changed

Dev/Meta

v2.6.4(Nov 16, 2022)

What's Fixed

v2.6.3(Sep 3, 2022)

What's New

What's Improved

What's Fixed

v2.6.2(Aug 28, 2022)

What's New