Difference between revisions of "Funkwhale"

From the Linux and Unix Users Group at Virginia Teck Wiki
Jump to: navigation, search
(Created page with "[https://funkwhale.audio/ Funkwhale] is a self-hosted music streaming service. VTLUUG currently runs a dockerized instance located at https://funkwhale.vtluug.org on sczi....")
 
Line 13: Line 13:
 
# Create a library by going to https://funkwhale.vtluug.org/content/libraries/.
 
# Create a library by going to https://funkwhale.vtluug.org/content/libraries/.
 
# Record the library ID of the library you want to add music too, located in the URL bar when you click on 'Detail' for a given library.
 
# Record the library ID of the library you want to add music too, located in the URL bar when you click on 'Detail' for a given library.
# On [[Infrastructure:Sczi sczi]]:
+
# On [[Infrastructure:Sczi|sczi]]:
 
## Become root (ask an officer for help)
 
## Become root (ask an officer for help)
 
## Go to <code>/nfs/cistern/docker/apps/sczi/funkwhale</code>
 
## Go to <code>/nfs/cistern/docker/apps/sczi/funkwhale</code>

Revision as of 04:34, 3 January 2019

Funkwhale is a self-hosted music streaming service. VTLUUG currently runs a dockerized instance located at https://funkwhale.vtluug.org on sczi. LDAP, invite codes, and the admin account are the only available login methods.

All music on Funkwhale is organized into user-specific libraries, and users may grant access to other users, the public, or to everyone on the instance. A big part of Funkwhale is the social aspect of sharing music with others.

Docker-compose configuration files are located on GitHub.

Importing Music

Funkwhale already has a pretty good guide located here, so this guide is specific to VTLUUG's configuration.


  1. Music must be located at /nfs/cistern/share/media/music/$username and must have proper metadata. Currently only FLAC, OGG/Vorbis, and MP3 files are supported but check here in case this guide is out of date.
  2. Create a library by going to https://funkwhale.vtluug.org/content/libraries/.
  3. Record the library ID of the library you want to add music too, located in the URL bar when you click on 'Detail' for a given library.
  4. On sczi:
    1. Become root (ask an officer for help)
    2. Go to /nfs/cistern/docker/apps/sczi/funkwhale
    3. Run export LIBRARY_ID="<your_libary_id>"
    4. Run docker-compose run --rm api python manage.py import_files $LIBRARY_ID "/nfs/cistern/share/media/music/$username/**/*.flac" --recursive --noinput
      1. Adjust the music type depending on your filetypes.