importing-music.rst

Importing music

From music directory on the server

You can import music files in funkwhale assuming they are located on the server and readable by the funkwhale application.

Assuming your music is located at /music and your music files contains at least an artist, album and title tag, you can import those tracks as follows:

docker-compose run --rm api python manage.py import_files "/music/**/*.ogg" --recursive --noinput

Note

This command is idempotent, meaning you can run it multiple times on the same files and already imported files will simply be skipped.

Warning

At the moment, only ogg files are supported. MP3 support will be implemented soon.

Getting demo tracks

If you do not have any music on your server but still want to test the import process, you can call the following methods do download a few albums licenced under creative commons (courtesy of Jamendo):

curl -L -o download-tracks.sh "https://code.eliotberriot.com/funkwhale/funkwhale/raw/master/demo/download-tracks.sh"
curl -L -o music.txt "https://code.eliotberriot.com/funkwhale/funkwhale/raw/master/demo/music.txt"
chmod +x download-tracks.sh
./download-tracks.sh music.txt

This will download a bunch of zip archives (one per album) under the data/music directory and unzip their content.