Following Libraries

Funkwhale’s major strength is its focus on federated sharing of music. Users can share music with one another through the network using library links.

Library Permissions

Libraries are set up with specific permissions that determine their visibility to users on the local instance and wider federated network. These permissions also determine whether or not follow requests need to be accepted by the library owner. These permissions are as follows:

  • Everyone, across all instances - the library will automatically accept follows from all users

  • Everyone on this instance - the library will automatically accept follows from users on the same instance, but external users will need to be accepted by the library owner

  • Nobody Except Me - all follows will need to be approved by the library owner

Following Other Libraries

Once you’ve got the library link, you can start following the library by doing the following:

  • Click on the “Add content” menu under “Music” on the left-hand side

  • Under “Follow Remote Libraries”, select “Get Started”

  • In the search bar that appears, paste the library link of the library you wish to follow

  • If the URL is valid, the name of the library will appear. Click “Follow” to start following the library

  • Once your follow request is approved, the library will be scanned for content (this will be automatic for public libraries)

  • Click on “Browse library” under “Music” on the left-hand side to return to the library overview

  • The library content should now be visible and playable on your instance

If another user on your instance has followed a library, you can follow it as well in case the user leaves or stops following it. To do this:

  • Select an item contained within the library on your instance

  • Scroll down to the “User libraries” section. You should see the name of the library in question

  • Click on “Follow”

Sharing Your Libraries

As well as being able to follow other users, you can also share your libraries with friends, family, and the network at large. To find your library link:

  • Navigate to https://your-instance/content/libraries or click “Add Content” under the “Music” menu, select “Upload audio content”, and click “Detail” under the library you want the code for

  • Under the “Followers” tab, you will be able to see information about followers this library currently has. The sharing link will also be visible

  • Click on “Copy” to copy the sharing link to your clipboard

  • Depending on the visibility settings you have chosen for the library, you will need to approve follow requests for those with whom you share the link