-
-
Notifications
You must be signed in to change notification settings - Fork 6
Users and sharing
DVinyl works great as a solo tool, but it also lets you share a collection with family, friends or a community. This page explains collections, roles and single sign-on, all in plain terms.
A collection is a library of items. You can have several, and each one is its own separate container. That means the same item can live in two collections independently, and each collection can have its own enabled media types, themes and members.
Common ways people use multiple collections:
- A personal library, just for you.
- A shared family library everyone can add to.
- A themed collection (for example a club's shared archive).
You can switch between the collections you have access to at any time.
When you share a collection, not everyone needs the same powers. DVinyl has three roles:
| Role | Can do |
|---|---|
| Admin | Full control: manage items, settings, media types and members. |
| Editor | Add, edit and remove items, but not change the collection settings or members. |
| Viewer | Browse the collection, but not change anything. |
Give trusted people editor access to help you build the library, and hand out viewer access to anyone you just want to show your shelf to.
You can keep a collection completely private, or open it up so others can view or help manage it. Invite people and assign each of them a role from the admin panel. Change or revoke access whenever you like.
If your server already uses an identity provider (Authentik, Keycloak, Authelia, pocketID and other OIDC providers), DVinyl can plug into it so you sign in with your existing account.
A couple of things worth knowing:
- SSO is optional and set up by the administrator through environment variables. See the
commented block in
.env.example. - SSO never creates accounts on its own. You first sign in with your DVinyl password, then link your identity from the Settings page. After that, you can log in with a single click.
This keeps things safe: only people who already have a DVinyl account can connect their SSO identity.
Ready to add a collection type that does not exist yet? Head to Create a custom plugin (no code).