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

72 lines
2.9 KiB
Markdown
Raw Normal View History

2020-06-10 08:57:49 +02:00
# Funkwhale for YunoHost
2018-05-11 23:43:58 +02:00
2020-12-14 21:50:23 +01:00
[![Integration level](https://dash.yunohost.org/integration/funkwhale.svg)](https://dash.yunohost.org/appci/app/funkwhale) ![](https://ci-apps.yunohost.org/ci/badges/funkwhale.status.svg) ![](https://ci-apps.yunohost.org/ci/badges/funkwhale.maintain.svg)
[![Install Funkwhale with YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=funkwhale)
2019-04-03 14:35:09 +02:00
2020-12-14 21:41:20 +01:00
*[Lire ce readme en français.](./README_fr.md)*
2020-06-18 15:30:22 +02:00
> *This package allows you to install Funkwhale quickly and simply on a YunoHost server.
If you don't have YunoHost, please consult [the guide](https://yunohost.org/#/install) to learn how to install it.*
2019-04-03 14:35:09 +02:00
## Overview
A modern, convivial and free music server on YunoHost
2018-05-12 13:17:09 +02:00
2020-06-18 15:30:22 +02:00
Installation requires a dedicated domain or subdomain. Installing in a subpath is not supported by the upstream project due to dependency requirements.
2021-08-04 23:30:55 +02:00
**Shipped version:** 1.1.4
2019-04-03 14:35:09 +02:00
## Screenshots
![](https://upload.wikimedia.org/wikipedia/commons/d/d8/Capture_d%27%C3%A9cran_de_la_page_d%27accueil_de_Funkwhale.png)
2019-04-03 14:35:09 +02:00
2020-12-14 21:41:20 +01:00
## Demo
* [Official demo](https://demo.funkwhale.audio)
**Username:** demo **Password:** demo
## Admin
2018-10-20 22:27:28 +02:00
The admin uses the login you provided at installation. The password is the same you use for YunoHost.
2020-12-14 21:50:23 +01:00
The admin interface is accessible at the address: `your.domain.fr/api/admin`
2021-04-21 23:35:59 +02:00
To add a collection of music files to a library in your YunoHost installation of Funkwhale, create a symlink to your collection titled "music" in `/home/yunohost.app/funkwhale/data`
```console
2021-04-21 23:35:59 +02:00
foo@bar:~$sudo ln -s /your/music/collection /home/yunohost.app/funkwhale/data/music
```
The files can then be added to your library from the *uploading* tab in a music library under the heading **Import music from your server**.
2019-05-14 22:55:26 +02:00
## Documentation
* Official documentation: https://docs.funkwhale.audio
2019-04-03 14:35:09 +02:00
## YunoHost specific features
2020-12-14 21:50:23 +01:00
* Are LDAP and HTTP auth supported? **Yes**
* Can the app be used by multiple users? **Yes**
2019-04-03 14:35:09 +02:00
#### Supported architectures
* x86-64 - [![Build Status](https://ci-apps.yunohost.org/ci/logs/funkwhale.svg)](https://ci-apps.yunohost.org/ci/apps/funkwhale/)
* ARMv8-A - [![Build Status](https://ci-apps-arm.yunohost.org/ci/logs/funkwhale.svg)](https://ci-apps-arm.yunohost.org/ci/apps/funkwhale/)
2019-04-03 14:35:09 +02:00
## Links
* Report a bug: https://github.com/YunoHost-Apps/funkwhale_ynh/issues
2019-05-14 22:55:26 +02:00
* App website: https://docs.funkwhale.audio
* Upstream app repository: https://dev.funkwhale.audio/funkwhale/funkwhale
* YunoHost website: https://yunohost.org/
2019-04-03 14:35:09 +02:00
---
## Developer info
2019-04-03 14:35:09 +02:00
Please send your pull request to the [testing branch](https://github.com/YunoHost-Apps/funkwhale_ynh/tree/testing).
2019-04-03 14:35:09 +02:00
To try the testing branch, please proceed like that.
```
sudo yunohost app install https://github.com/YunoHost-Apps/funkwhale_ynh/tree/testing --debug
or
sudo yunohost app upgrade funkwhale -u https://github.com/YunoHost-Apps/funkwhale_ynh/tree/testing --debug
```