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” sectionClick 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” sectionClick “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” sectionClick “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” sectionClick “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” sectionClick “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”