thrash.dev

docs / providers / jellyfin

Providers · chapters · 04 of 25

← Yafmp manual

  1. Local Files
  2. Plex
  3. Navidrome
  4. Jellyfin
  5. Bandcamp
  6. Lidarr
  7. Apple Music
  8. Spotify
  9. SoundCloud
  10. YouTube Music
  11. SiriusXM
  12. Radio
  13. Podcasts
  14. AirPlay
  15. Chromecast
  16. MusicBrainz
  17. Discogs
  18. Labels
  19. Releases
  20. Last.fm
  21. ListenBrainz
  22. Connect
  23. Home Assistant
  24. MCP server
  25. DJ

Jellyfin

Browse and play your Jellyfin server's music: original files, lossless.

facts

status
beta
kind
source
on by default
yes
needs
Jellyfin server with a music library, User name and password on that server
platforms
iPhone, iPad, Mac, Vision Pro, Apple TV

Description

Jellyfin puts the music of your Jellyfin server in Yafmp’s library panel. Yafmp asks the server for the original file and plays it as it is, so a FLAC stays lossless. Nothing is transcoded.

The library shows Artists, Albums, Recently Added (the newest 100 albums), Genres and Playlists. With more than 150 entries, Artists and Albums are split into A–Z folders, each loaded when you open it. Search covers artists, albums and songs. Covers come from the server.

Jellyfin is in the Apple edition only. It is not in the Android and desktop edition.

Requirements

  • A Jellyfin server that the device can reach, with a music library.
  • A user name and password on that server.
  • An address that starts with https:// or http://. Plain http:// works only for .local names and IP addresses; use https for anything else.

Setup

  1. Open Preferences → Plugins → Jellyfin. On Apple TV, open Settings and find the Jellyfin section.
  2. In Address, enter the server’s address with its port, for example http://<server>.local:8096.
  3. Enter User and Password.
  4. Choose Sign In.
  5. When Status shows the server’s name and version, the Jellyfin rows appear in the library.

Settings

SettingDefaultWhat it does
Address—The server’s address, with https:// or http://.
User—Your user name on the server.
Password—Your password. Used once to sign in; it is not stored.
Sign In—Signs in and connects.
Sign Out—Signs out on the server and forgets the sign-in token. Shown while signed in.
Status—The server’s name and version once connected, or what went wrong. Read-only.

Only the sign-in token the server returns is kept, in the system keychain. The address, user name and token are shared with your other Apple devices through iCloud Keychain. Each device still appears to the server as its own device.

Limits

  • Music only. Yafmp does not play Jellyfin video.
  • Playback is the original file. A file the device can’t decode will not play; there is no fallback to a transcoded stream.
  • The address of a stream carries your sign-in token. Away from home, use an https address.
  • Search returns at most 60 results.
  • A playlist is read up to 5,000 tracks.
  • Yafmp keeps the lists it has loaded until you refresh or reconnect.
  • Refresh asks the server to scan its libraries. Servers only accept that from an admin user. Yafmp does not wait for the scan, so new files can take a minute to appear.
  • Volume levelling uses the gain Jellyfin has analysed (Jellyfin 10.9 and later). Tracks it has not analysed play at their own level.

Troubleshooting

ProblemWhyWhat to do
“Wrong user name or password.”The server refused the sign-inEnter the user name and password again and choose Sign In.
“Sign in again in Preferences → Plugins → Jellyfin.”The server no longer accepts the saved tokenEnter the password and choose Sign In.
“The server answered HTTP …”The address reaches something that is not the Jellyfin serverCheck the address and the port.
New albums are missingYafmp keeps the lists it has loadedRight-click (or long-press) the Jellyfin heading in the library and choose Refresh. If they are still missing, wait a minute and refresh again.