Managing Libraries

Managing your music libraries is an important part of using Funkwhale. In addition to uploading new music, you may also want to edit your library’s details, delete a library, or remove content from a library.

If you are looking to publish content on Funkwhale directly, you can use channels instead

Creating a Library

To upload content to a library, you will first need to create one. To do this:

Navigate to https://your-instance/content/libraries or click on the upload icon and click on “Get Started” under the “Upload third-party content in a library” section
Click on the “Create a new library” option under the “My Libraries” header to bring up the creation screen
Enter the name, description, and privacy level of the library. The privacy level can be one of the following:
- Public: anyone can follow the library to automatically access its content (including users on other instances)
- Local: other users from your instance can follow the library to automatically access its content
- Private: nobody apart from you can access the library content
Click “Create Library” to save your changes

Uploading Content to a Library

Note

Content you upload to a library will inherit the privacy level of the library itself. Content not distributed under a permissive library should only be placed in private libraries

Once you have created a library, you can start adding files to it. Before you upload files, it is a good idea to tag them correctly to make sure they have the right metadata associated with it.

To upload content:

Navigate to https://your-instance/content/libraries or click on the upload icon in the sidebar and click on “Get Started” under the “Upload third-party content in a library” section
Click “Upload” under the library you wish to edit
You will see a summary of the upload date and information. Click “Proceed” to continue
Drag and drop the files you would like to upload or click on the upload section to open the file picker and open the files
The “Processing” tab will show the status of the uploads including any errors or warnings

Note

If you try to navigate away from the upload screen before everything has finished uploading, you will be asked to confirm the navigation

Editing a Library

To change details about a library:

Navigate to https://your-instance/content/libraries or click on the upload icon in the sidebar and click on “Get Started” under the “Upload third-party content in a library” section
Click “Detail” under the library you wish to edit
Select “Edit” from the menu that appears
In the edit menu, you will be able to change the name, description, and visibility of your library
Make the changes you wish to make, then select “Update library” to save the changes

Deleting a Library

Warning

Deleting a library will also delete any content within the library. Make sure that content is backed up before continuing.

To delete a library:

Navigate to https://your-instance/content/libraries or click on the upload icon in the sidebar and click on “Get Started” under the “Upload third-party content in a library” section
Click “Detail” under the library you wish to edit
Select “Edit” from the menu that appears
Select “Delete” from the bottom of the menu. A pop up will appear warning of the consequences of deleting the library. If you want to continue, click “Delete library”

Removing Content From a Library

Warning

Removing content from your library deletes the file from the server. Make sure you have a backup of any files you want to keep.

To delete content from a library:

Navigate to https://your-instance/content/libraries or click on the upload icon in the sidebar and click on “Get Started” under the “Upload third-party content in a library” section
Click “Detail” under the library you wish to edit- Select “Tracks” from the menu that appears
Select all tracks you wish to remove by selecting the checkboxes next to them
In the “Actions” drop down menu, select “Delete” and click “Go”. A pop up will appear warning of the consequences of deleting the library. If you want to continue, click “Launch”