2022-07-08 12:41:53 +02:00
# WE HAVE MOVED
Ultrasonic code is now hosted in [GitLab][ultrasonic].
- New Web: https://ultrasonic.gitlab.io
- New Git: https://gitlab.com/ultrasonic/ultrasonic
- New bugtracker: https://gitlab.com/ultrasonic/ultrasonic/-/issues
- New releases: https://gitlab.com/ultrasonic/ultrasonic/-/issues
[ultrasonic]: https://gitlab.com/ultrasonic/ultrasonic
2016-05-11 20:13:33 +02:00
# Ultrasonic
2017-07-30 16:09:44 +02:00
2022-07-08 12:41:53 +02:00
Ultrasonic is free and open-source music streaming Android client for
[Subsonic][subsonic] [API][subapi] (version 1.7.0 or higher) compatible
servers.
2016-05-11 20:13:33 +02:00
2020-03-09 13:06:09 +01:00
## Help wanted
We currently don't have that much time to spend developing Subsonic, so any
contributions or active developers are always welcomed.
2022-07-08 12:41:53 +02:00
Have a look at [CONTRIBUTING ](CONTRIBUTING.md ) to get started.
2020-03-09 13:06:09 +01:00
2017-12-10 13:44:52 +01:00
## Download
2016-05-11 20:13:33 +02:00
2017-12-27 17:18:57 +01:00
App is available to download at following stores:
2017-12-16 22:35:09 +01:00
[<img src="https://play.google.com/intl/en_us/badges/images/generic/en-play-badge.png" alt="Get it on Google Play" height="70"> ](https://play.google.com/store/apps/details?id=org.moire.ultrasonic )
[<img src="https://f-droid.org/badge/get-it-on.png" alt="Get it on F-Droid" height="70"> ](https://f-droid.org/packages/org.moire.ultrasonic/ )
2022-07-08 12:41:53 +02:00
[<img src="https://ultrasonic.gitlab.io/assets/img/get-it-on-gitlab.png" alt="Get it on GitLab" height="70"> ](https://gitlab.com/ultrasonic/ultrasonic/-/releases )
2020-03-09 13:06:09 +01:00
**Warning**: All three versions (Google Play, F-Droid and the APKs) are not
compatible (not signed by the same key)! You must uninstall one to install
2022-07-08 12:41:53 +02:00
the other, which will delete all your data.
2021-09-10 12:04:37 +02:00
2022-07-08 12:41:53 +02:00
If you want to use the version downloaded from F-Droid or from GitLab with
**Android Auto**, you must enable Unknown Sources as it is described in
[this wiki page][wikiaa].
2017-12-27 17:18:57 +01:00
2018-02-15 20:28:07 +01:00
## Bugs and issues
2016-05-11 20:13:33 +02:00
2022-07-08 12:41:53 +02:00
First, see if your issue haven’ t been yet reported [here][issues], otherwise
open [a new issue][newissue].
2016-05-11 20:13:33 +02:00
2018-02-15 20:28:07 +01:00
### Known (not our) bugs
If you are using *Madsonic 5.1.X* several sections of Ultrasonic will not
work. This is caused by bad implementation of Subsonic API by Madsonic. For
2022-07-08 12:41:53 +02:00
more info about this you can read [this bug][madbug].
2018-02-15 20:28:07 +01:00
2017-12-10 13:44:52 +01:00
## Contributing
2016-05-11 20:13:33 +02:00
2017-12-10 13:44:52 +01:00
See [CONTRIBUTING ](CONTRIBUTING.md ).
2017-12-27 22:25:59 +01:00
## Supported (tested) Subsonic API implementations
2022-07-08 12:41:53 +02:00
- [Subsonic][subsonic]
- [Airsonic-Advanced][airsonic]
- [Supysonic][supysonic]
- [Ampache][ampache]
2017-12-27 22:25:59 +01:00
2022-07-08 12:41:53 +02:00
Other *Subsonic API* implementations should work as well as long as they
follow API [documentation][subapi].
2017-12-27 22:25:59 +01:00
2017-12-10 13:44:52 +01:00
## License
2022-07-08 12:41:53 +02:00
This software is licensed under the terms of the GNU General Public License
version 3 (GPLv3).
Full text of the license is available in the [LICENSE ](LICENSE ) file and
[online][gpl3].
[wikiaa]: https://gitlab.com/ultrasonic/ultrasonic/-/wikis/Using-Ultrasonic-with-Android-Auto
[issues]: https://gitlab.com/ultrasonic/ultrasonic/-/issues
[newissue]: https://gitlab.com/ultrasonic/ultrasonic/-/issues/new
[madbug]: https://gitlab.com/ultrasonic/ultrasonic/-/issues/129
[subsonic]: http://www.subsonic.org/
[subapi]: http://www.subsonic.org/pages/api.jsp
[airsonic]: https://github.com/airsonic-advanced/airsonic-advanced
[supysonic]: https://github.com/spl0k/supysonic
[ampache]: https://ampache.org/
[gpl3]: https://opensource.org/licenses/gpl-3.0.html