6.8 KiB
Auxio - Frequently Asked Questions
This FAQ will be continually updated as new changes and updates are made to Auxio.
Where can I download Auxio?
Auxio is available on the F-Droid repository. Auxio is not and will never be on the play store due to it being a proprietary and draconian platform.
Why ExoPlayer?
Unlike the stock MediaPlayer API that most music apps use, ExoPlayer is independent from the android system's
audio framework. This allows for the following:
- Consistent behavior across devices and OS versions
- Features that are normally not possible with a normal audio stream (such as positive ReplayGain values)
- Playback to be (theoretically) be extended beyond local files in the future
You can read more about the benefits (and drawbacks) of ExoPlayer Here.
What formats does Auxio support?
As per the Supported ExoPlayer Formats, Auxio supports MP4, MP3, MKA, OGG, WAV, MPEG, AAC on all versions of Android. Auxio also supports FLAC on all versions of Android through the use of the ExoPlayer FLAC extension.
Auxio doesn't load my music correctly!
This depends on the context:
- If "Ignore MediaStore Tags" is enabled, please file an issue with your particular issue.
- If "Ignore MediaStore Tags" is not enabled, please check below to make sure your issue is not already awknowledged before reporting an issue.
Moreso, if the issue encountered does not appear in other apps like Music Player GO, Phonograph, Vinyl, Retro Music, VLC, or Vanilla, then it should be reported.
Known unfixable music loading issues
These are a list of unfixable music loading issues that can only be fixed by enabling "Ignore MediaStore Tags":
My FLAC/OGG/OPUS files don't have dates: Android does not read the DATE tag from vorbis files. It reads the YEAR tag. This is because android's metadata parser is
stuck in 2008.
Some files with accented/symbolic characters have corrupted tags: When Android extracts metadata, at some point it tries to convert the bytes it extracted to a java string, which apparently involves detecting the encoding of the data dynamically and then converting it to Java's Unicode dialect. Of course, trying to detect codings on the fly like that is a terrible idea, and more often than not it results in UTF-8 tags (Seen on FLAC/OGG/OPUS files most often) being corrupted.
I have a large library and Auxio takes really long to load it: This is expected since reading from the audio database takes awhile, especially with libraries containing 10k songs or more.
Auxio does not detect disc numbers: If your device runs Android 10, then Auxio cannot parse a disc from the media database due to a regression introduced by Google in that version. If this issue appears in another android version, please file an issue.
Other music loading issues
There should be one artist, but instead I get a bunch of "Artist & Collaborator" artists: This likely means your tags are wrong. By default, Auxio will use the "album artist" tag for grouping if present, falling back to the "artist" tag otherwise. If your music does not have such a field, it will result in fragmented artists. The reason why Auxio does not simply parse for separators and then extract artists that way is that it risks mangling artists that don't actually have collaborators, such as "Black Country, New Road" becoming "Black Country".
Auxio does not detect new music: This is Auxio's default behavior due to limitations regarding android's filesystem APIs. To enable such behavior, turn on "Automatic reloading" in settings. Note that this option does require a persistent notification and higher battery usage.
Why are my songs/albums/artists out of order?
Auxio takes sort tags (like TSOT or TITLESORT) into account when sorting, which could cause items to
appear in unexpected places. If your items do not have sort tags, please file an issue.
Why does search return songs that don't match my query?
Auxio actually takes several types of metadata in account in searching:
- The name, normalized so that any accented/symbolic characters are converted to normal characters. For example, Ü -> U.
- The sort tag of a particular song/album/artist, as such often contain latinized/translated versions of a given title.
- The file name, as some users don't have usable title metadata, and instead use the file name as the title.
Why does playback pause whenever music is reloaded?
Whenever the music library signifigantly changes, updating the player's data while it is still playing may result in unwanted bugs or unexpected music playing. To safeguard against this, Auxio will pause whenever it reloads a new music library.
ReplayGain isn't working on my music!
This is for a couple reason:
- Auxio doesn't extract ReplayGain tags for your format. This is a problem on ExoPlayer's end and should be investigated there.
- Auxio doesn't recognize your ReplayGain tags. This is usually because of a non-standard tag like ID3v2's
RVADor an unrecognized name.
My lossless audio sounds lower-quality in Auxio!
This is a current limitation with the ExoPlayer. Basically, all audio is downsampled to 16-bit PCM audio, even if the source audio is higher quality. I can enable something that might be able to remedy such, but implementing it fully may take some time.
Why is playback distorted when I play my FLAC/WAV files?
ExoPlayer, while powerful, does add some overhead when playing exceptionally high-quality files (2000+ KB/s bitrate, 90000+ Hz sample rate). This is worsened by the ReplayGain system, as it has to copy the audio buffer no matter what. This results in choppy, distorted playback in some cases as audio data cannot be delivered in time. Sadly, there is not much I can do about this right now.
Why are accents lighter/less saturated in dark mode?
As per the Material Design Guidelines, accents should be less saturated on dark mode to reduce eye strain and to increase visual cohesion.
Does this app keep/send any information about myself or my device?
Auxio does not log any information about the device or its owner, and it has no internet access to send that information off in the first place.
How can I contribute/report issues?
Open an Issue or a Pull Request, please note the Contribution Guidelines and Accepted Additions however.
Can I translate Auxio to my native language?
Please go to Auxio's Weblate Project to create new translations for the project.