Hide the new quality tags option for now.

This is not because I wanted to, but rather because of me wanting to
reduce the amount of bugs I will likely be thrown due to the release
of automatic rescanning.

2022-07-08 16:48:28 -06:00

6.1 KiB

Raw Blame History

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 is probably caused by one of two reasons:

If other players like Phonograph, Retro Music, or Music Player GO load it correctly, then Auxio has a bug and it should be reported.
If the aforementioned players don't work, but players like Vanilla Music and VLC do, then it's a problem with the Media APIs that Auxio relies on. There is nothing I can do about it.
- I hope to mitigate these issues in the future by extracting metadata myself or adding Subsonic/SoundPod support, however this is extremely far off.

Some common issues are listed below.

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 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 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.

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".

Why does Auxio not detect disc numbers on my device?

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 your device is running another version, please file an issue.

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 RVAD or 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.

6.1 KiB Raw Blame History