kopia lustrzana https://dev.funkwhale.audio/funkwhale/funkwhale
61 wiersze
3.3 KiB
ReStructuredText
61 wiersze
3.3 KiB
ReStructuredText
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
|
|
|
|
Getting Library Links
|
|
---------------------
|
|
|
|
The first step to following a library is getting a valid library link. These links typically look like
|
|
``https://instance-url/federation/music/libraries/a-random-string-of-numbers-and-letters``. Users can
|
|
share their library links with you directly, or you can find the library links for public libraries by
|
|
visiting their instance. To do this:
|
|
|
|
- Visit the instance containing the library you wish to follow
|
|
- Select an item contained within the library
|
|
- Scroll down to the "User libraries" section. You should see the name of the library in question
|
|
- The library link will be under "Sharing link". Click on "Copy" to copy the link to your clipboard
|
|
|
|
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
|