Skip to content

Repository files navigation

License: GPL-3.0-only

Kofin for Jellyfin

Kodi video and music addon for Jellyfin. Browse Jellyfin libraries through the add-on or sync selected libraries directly into Kodi's own databases, so Jellyfin content appears as a native Kodi library.

A rewrite of jellyfin-kodi on the principle "rewrite the shell, transplant the organs": new entry points, settings and lifecycle wrapped around the proven Kodi database writers.

For Jellyfin Live TV, see the companion Kofin PVR addon.

Requires: Kodi 21 "Omega" or Kodi 22 "Piers". Jellyfin 10.11.x or later.

Features

New

  • Robust, resumable sync
  • SyncPlay - watch in sync with other Jellyfin clients
  • Integrated media segment skipping and play next episode prompt
  • Access movie special features / extras natively
  • Multi-version movies as native Kodi video versions (Jellyfin MediaSources)
  • Jellyfin song lyrics, timed or plain, handed to Kodi as a song starts - needs an addon that displays lyrics, such as CU LRC Lyrics, since no stock skin shows them
  • Flexible playback methods - direct play, remux or transcode. Choose supported HDR formats & max resolution
    • For transcoded playback, audio streams and image-based subtitles can be accessed after playback starts by returning to the playing item and bringing up the context menu.
  • Play with transcoding context item: pick a bitrate
  • Sync Jellyfin music playlists into Kodi as native playlists under Music → Playlists → Kofin

Legacy

  • Who's watching? - toggle additional users onto the session for multi-user watch state
  • Sync Jellyfin movies, TV shows, music and music videos into Kodi's native library
  • Real Kodi database rows - skins, widgets and "recently added" work with no plugin awareness
  • Incremental and full sync
  • Real-time updates over websocket, with a fast change-feed path when the server companion plugin is installed
  • Login with username and password, or Quick Connect

Removed

  • Native mode playback, all playback is streamed via Jellyfin.

Installation

Install via the Kontell Repository.

Migration from Jellyfin-Kodi

  1. Remove all libraries via jellyfin
  2. Reset local database

Configuration

  • After install the addon appears under Add-ons → Video add-ons → Kofin.
  • Enter settings and open the Account tab, enter your server address and sign in.
  • Libraries can now be browsed in a similar manner to typical Kodi add-ons.
  • To sync libraries into the local Kodi database:
    • From settings go to the Library tab, choose which server libraries to mirror. The background service syncs them into Kodi's library - the first sync can take a while, later ones are incremental.
  • Sync, Playback and Transcoding each have their own settings tab for sync behaviour, media segments / Play Next / SyncPlay, and the transcoding profiles.

Server address

  • The server address may be a bare host or IP (e.g. 192.168.1.10), a host:port, or a full URL. http and port 8096 are assumed when the scheme and port are omitted. Use https:// when connecting over the internet.
  • On login the addon stores a Jellyfin access token (not your password) in Kodi's addon settings. Like all Kodi addon settings it is kept in plaintext under userdata/addon_data/plugin.video.kofin/ - be aware of this when sharing Kodi backups or your addon_data folder. Signing out revokes the token on the server.

Companion server plugin

For improved syncing performance install the KofinSyncQueue server plugin. it gives the add-on a typed change feed so catch-up only touches what actually changed. Without it Kofin still works, using the official KodiSyncQueue plugin or real-time websocket updates.

Supported platforms

Kofin is pure Python and runs anywhere Kodi 21 /22 does. Because library sync writes Kodi's own database, it is gated to the schema versions it has been proven against; any other version is refused for writing (browsing and playback still work) until support is added.

Kodi Video database Music database
21 "Omega" MyVideos131 MyMusic83
22 "Piers" MyVideos146 MyMusic84

About

Jellyfin Client for Kodi

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages