Playback
Jellyfin Integration: Private Playlists Per User
Jellyfin integration publishes each Aurral playlist as a private playlist on the Jellyfin user with the same username, using the bare playlist name.
How the mapping works
An Aurral playlist owned by the user alice becomes a private Jellyfin playlist on the Jellyfin account named alice. The bare name is used with no prefix, because Jellyfin already scopes playlists per user.
Private means other Jellyfin users cannot see it. That is the right default for discovery mixes, since a personal weekly mix is not meant for the rest of the household by default.
Account requirements
A Jellyfin user must exist with the same username as the Aurral user, otherwise there is nowhere to publish. Aurral needs API credentials with permission to create and manage playlists on those accounts.
The address Aurral uses must be reachable from Aurral. In a Docker network that is the internal service name, not the hostname your browser happens to use.
Cleanup behaviour
Before Aurral removes files on its own — a Flow rotating out, a synced playlist dropping a track, or an upgrade replacing a file — it asks each connected playback server which files its playlists still use. Anything a Jellyfin playlist still references is kept.
If Jellyfin is unreachable, cleanup is deferred and retried later. Explicit deletions you perform yourself skip that check, because you already decided.
Frequently asked questions
Do other family members see these playlists?
No. They are created as private playlists on the matching Jellyfin user.
What if the usernames do not match?
The playlist has nowhere to publish. Create a Jellyfin user with the same name as the Aurral user, or rename one of them.
Is Jellyfin or Navidrome better for this?
Navidrome is easier because it accepts playlist files written into the library directory. Jellyfin needs the API and a matching user per account.
Everything else
All integrations
Library
The music manager decides what ends up on disk. Aurral never writes into someone else's library folder.
Downloads
Where the audio actually comes from. Source order decides which client gets asked first.
Playback
Playback stays where it is. Aurral publishes playlists into the server you already run.
Listening history
History is the strongest recommendation signal you already own. Wire it in and the picks improve.
Alerts and shows
Optional signals that turn a static library into something that keeps moving.
Connect Jellyfin to the rest of your stack
Nothing here requires restarting anything else. Add it when it becomes the piece you were missing.