55 lines
2.6 KiB
Markdown
55 lines
2.6 KiB
Markdown
# Ultrasonic
|
||
[](https://circleci.com/gh/ultrasonic)
|
||
[]()
|
||
[](https://ktlint.github.io/)
|
||
|
||
Ultrasonic is free and open-source music streaming Android client for [Subsonic](http://www.subsonic.org/) [API](http://www.subsonic.org/pages/api.jsp) (version 1.7.0 or higher) compatible servers.
|
||
|
||
## Help wanted
|
||
|
||
We currently don't have that much time to spend developing Subsonic, so any
|
||
contributions or active developers are always welcomed.
|
||
|
||
## Download
|
||
|
||
App is available to download at following stores:
|
||
|
||
[<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/)
|
||
[<img src="https://ultrasonic.github.io/assets/img/get-it-on-github.png" alt="Get it on GitHub" height="70">](https://github.com/ultrasonic/ultrasonic/releases)
|
||
|
||
**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
|
||
the other, which will delete all your data.
|
||
|
||
## Bugs and issues
|
||
|
||
First, see if your issue haven’t been yet reported [here](https://github.com/ultrasonic/ultrasonic/issues),
|
||
otherwise open [a new issue](https://github.com/ultrasonic/ultrasonic/issues/new).
|
||
|
||
### 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
|
||
more info about this you can read [this bug](https://github.com/ultrasonic/ultrasonic/issues/129).
|
||
|
||
## Contributing
|
||
|
||
See [CONTRIBUTING](CONTRIBUTING.md).
|
||
|
||
## Supported (tested) Subsonic API implementations
|
||
|
||
- [Subsonic](http://www.subsonic.org/pages/index.jsp)
|
||
- [Airsonic](https://github.com/airsonic/airsonic)
|
||
- [Supysonic](https://github.com/spl0k/supysonic)
|
||
- [Ampache](https://ampache.org/)
|
||
|
||
Other *Subsonic API* implementations should work as well as long as they follow API
|
||
[documentation](http://www.subsonic.org/pages/api.jsp).
|
||
|
||
## License
|
||
|
||
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](https://opensource.org/licenses/gpl-3.0.html).
|