funkwhale_ynh icon indicating copy to clipboard operation
funkwhale_ynh copied to clipboard

A modern, convivial and free music server on YunoHost

Funkwhale for YunoHost

Integration level Working status Maintenance status
Install Funkwhale with YunoHost

Lire ce readme en français.

This package allows you to install Funkwhale quickly and simply on a YunoHost server. If you don't have YunoHost, please consult the guide to learn how to install it.

Overview

Funkwhale is a community-driven project that lets you listen and share music and audio within a decentralized, open network.

Shipped version: 1.2.7~ynh1

Demo: https://demo.funkwhale.audio

Screenshots

Screenshot of Funkwhale

Disclaimers / important information

  • Installation requires a dedicated domain or subdomain. Installing in a subpath is not supported by the upstream project due to dependency requirements.

  • Admin

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

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

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.

Documentation and resources

Developer info

Please send your pull request to the testing branch.

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

More info regarding app packaging: https://yunohost.org/packaging_apps