2021-10-23 16:53:03 +02:00
<!--
N.B.: This README was automatically generated by https://github.com/YunoHost/apps/tree/master/tools/README-generator
It shall NOT be edited by hand.
-->
2020-06-10 08:57:49 +02:00
# Funkwhale for YunoHost
2018-05-11 23:43:58 +02:00
2022-07-13 17:29:01 +02:00
[![Integration level ](https://dash.yunohost.org/integration/funkwhale.svg )](https://dash.yunohost.org/appci/app/funkwhale) ![Working status ](https://ci-apps.yunohost.org/ci/badges/funkwhale.status.svg ) ![Maintenance status ](https://ci-apps.yunohost.org/ci/badges/funkwhale.maintain.svg )
2020-12-19 19:53:20 +01:00
[![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)*
2021-10-23 16:53:03 +02:00
> *This package allows you to install Funkwhale quickly and simply on a YunoHost server.
2021-04-16 14:14:27 +02:00
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
2018-05-12 13:17:09 +02:00
2021-11-23 07:46:19 +01:00
Funkwhale is a community-driven project that lets you listen and share music and audio within a decentralized, open network.
2018-06-17 15:54:08 +02:00
2022-10-04 01:43:33 +02:00
**Shipped version:** 1.2.8~ynh2 *(:warning: This is the `upgrade` branch. The [`master` branch](https://github.com/YunoHost-Apps/funkwhale_ynh/tree/master) used in the catalog is currently on version 1.2.8\~ynh1.)*
2018-06-17 15:54:08 +02:00
2022-09-14 11:10:20 +02:00
2021-10-23 16:53:03 +02:00
**Demo:** https://demo.funkwhale.audio
2022-07-14 14:03:39 +02:00
## Screenshots
![Screenshot of Funkwhale ](./doc/screenshots/screenshot1.png )
2021-10-23 16:53:03 +02:00
## Disclaimers / important information
2020-12-14 21:41:20 +01:00
2022-07-14 14:08:13 +02:00
* Installation requires a dedicated domain or subdomain. Installing in a subpath is not supported by the upstream project due to dependency requirements.
2020-12-14 21:41:20 +01:00
2021-10-23 16:53:03 +02:00
* Admin
2022-10-04 00:34:36 +02:00
* The admin uses the login you provided at installation. The password is the same you use for YunoHost.
* The admin interface is accessible at the address: `your.domain.fr/api/admin`
2018-06-20 12:49:40 +02:00
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`
2021-04-15 14:30:36 +02:00
```console
2021-04-21 23:35:59 +02:00
foo@bar:~$sudo ln -s /your/music/collection /home/yunohost.app/funkwhale/data/music
2021-04-15 14:30:36 +02:00
```
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** .
2021-10-23 16:53:03 +02:00
## Documentation and resources
2020-12-04 18:09:35 +01:00
2022-07-13 17:29:01 +02:00
* Official app website: < https: // funkwhale . audio />
* Official user documentation: < https: // docs . funkwhale . audio / users / index . html >
* Official admin documentation: < https: // docs . funkwhale . audio / admin / index . html >
* Upstream app code repository: < https: // dev . funkwhale . audio / funkwhale / funkwhale >
* YunoHost documentation for this app: < https: // yunohost . org / app_funkwhale >
* Report a bug: < https: // github . com / YunoHost-Apps / funkwhale_ynh / issues >
2019-04-03 14:35:09 +02:00
2021-04-16 14:14:27 +02:00
## Developer info
2019-04-03 14:35:09 +02:00
2021-04-16 14:14:27 +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.
2022-07-13 17:29:01 +02:00
``` bash
2019-04-03 14:35:09 +02:00
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
```
2021-10-23 16:53:03 +02:00
2022-07-13 17:29:01 +02:00
**More info regarding app packaging:** < https: / / yunohost . org / packaging_apps >