1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/airsonic_ynh.git synced 2024-09-03 18:06:14 +02:00
airsonic_ynh/README.md

72 lines
3.4 KiB
Markdown
Raw Normal View History

2019-05-22 22:10:48 +02:00
# Airsonic for YunoHost
2019-02-06 19:37:46 +01:00
2019-05-22 22:10:48 +02:00
[![Integration level](https://dash.yunohost.org/integration/airsonic.svg)](https://dash.yunohost.org/appci/app/airsonic)
[![Install airsonic with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=airsonic)
2019-02-06 19:37:46 +01:00
2019-05-22 22:10:48 +02:00
> *This package allow you to install airsonic quickly and simply on a YunoHost server.
2019-02-06 19:37:46 +01:00
If you don't have YunoHost, please see [here](https://yunohost.org/#/install) to know how to install and enjoy it.*
## Overview
2019-05-22 22:10:48 +02:00
Airsonic is a free, web-based media streamer, providing ubiquitous access to your music. Use it to share your music with friends, or to listen to your own music while at work. You can stream to multiple players simultaneously, for instance to one player in your kitchen and another in your living room.
Airsonic is designed to handle very large music collections (hundreds of gigabytes). Although optimized for MP3 streaming, it works for any audio or video format that can stream over HTTP, for instance AAC and OGG. By using transcoder plug-ins, Airsonic supports on-the-fly conversion and streaming of virtually any audio format, including WMA, FLAC, APE, Musepack, WavPack and Shorten.
If you have constrained bandwidth, you may set an upper limit for the bit rate of the music streams. Airsonic will then automatically re sample the music to a suitable bit rate.
In addition to being a streaming media server, Airsonic works very well as a local jukebox. The intuitive web interface, as well as search and index facilities, are optimized for efficient browsing through large media libraries. Airsonic also comes with an integrated Podcast receiver, with many of the same features as you find in iTunes.
2019-02-06 19:37:46 +01:00
2019-07-19 19:31:48 +02:00
**Shipped version:** 10.4.0
2019-02-06 19:37:46 +01:00
## Screenshots
2019-05-22 22:10:48 +02:00
![](https://airsonic.github.io/demo/screenshot_01.png)
2019-02-06 19:37:46 +01:00
## Demo
2019-05-22 22:10:48 +02:00
* [Official demo](https://airsonic.github.io/demo/)
2019-02-06 19:37:46 +01:00
## Configuration
2019-05-22 22:10:48 +02:00
How to configure this app: by an admin panel.
2019-02-06 19:37:46 +01:00
## Documentation
2019-05-22 22:10:48 +02:00
* Official documentation: https://airsonic.github.io/docs/
2019-02-06 19:37:46 +01:00
## YunoHost specific features
#### Multi-users support
2019-05-22 22:10:48 +02:00
Are LDAP and HTTP auth supported? **Yes**
2019-02-06 19:37:46 +01:00
#### Supported architectures
2019-05-22 22:10:48 +02:00
* x86-64b - [![Build Status](https://ci-apps.yunohost.org/ci/logs/airsonic%20%28Apps%29.svg)](https://ci-apps.yunohost.org/ci/apps/airsonic/)
* ARMv8-A - [![Build Status](https://ci-apps-arm.yunohost.org/ci/logs/airsonic%20%28Apps%29.svg)](https://ci-apps-arm.yunohost.org/ci/apps/airsonic/)
* Jessie x86-64b - [![Build Status](https://ci-stretch.nohost.me/ci/logs/airsonic%20%28Apps%29.svg)](https://ci-stretch.nohost.me/ci/apps/airsonic/)
2019-02-06 19:37:46 +01:00
**More information on the documentation page:**
https://yunohost.org/packaging_apps
## Links
2019-05-22 22:10:48 +02:00
* Report a bug: https://github.com/YunoHost-Apps/airsonic_ynh/issues
* App website: https://airsonic.github.io/
* Upstream app repository: https://github.com/airsonic/airsonic
2019-02-06 19:37:46 +01:00
* YunoHost website: https://yunohost.org/
---
Developers info
----------------
**Only if you want to use a testing branch for coding, instead of merging directly into master.**
2019-05-22 22:10:48 +02:00
Please do your pull request to the [testing branch](https://github.com/YunoHost-Apps/airsonic_ynh/tree/testing).
2019-02-06 19:37:46 +01:00
To try the testing branch, please proceed like that.
```
2019-05-22 22:10:48 +02:00
sudo yunohost app install https://github.com/YunoHost-Apps/airsonic_ynh/tree/testing --debug
2019-02-06 19:37:46 +01:00
or
2019-05-22 22:10:48 +02:00
sudo yunohost app upgrade airsonic -u https://github.com/YunoHost-Apps/airsonic_ynh/tree/testing --debug
2019-02-06 19:37:46 +01:00
```