Skip to content

Jellyfin

Jellyfin is a media source, not a player. It browses your library and hands back a stream URL, which a rule then sends to a real player such as Kodi or VLC.

Talks to the Jellyfin server over its HTTP API, with a WebSocket for now-playing updates. Servers are found on the network over UDP discovery on port 7359. Authentication is an API key. Because it only resolves what to play, it never streams the video itself — it points a player at the content.

  • serverUrl — the base URL of your Jellyfin server.
  • apiKey — a Jellyfin API key (stored as a secret).
  • userId — the Jellyfin user whose library to browse.
CommandWhat it does
searchSearch the library
stream_urlResolve a direct-play URL for an item

It carries the media.library trait and supports navigation, so the library is browsable with posters. It emits library.play and library.queue events (route these with a rule to a player), plus session.changed and session.stopped.