Jellyfin TubeArchivist Plugin

Important

Jellyfin release cycle has changed in the past few months and now it is shorter than before. The plugin supports only the latest Jellyfin release, in order to continue using this plugin with all the latest features you will need to upgrade your Jellyfin installation.

About

This plugin adds the metadata provider for TubeArchivist, offering improved flexibility and native integration with Jellyfin compared to previous solutions.

How it works

The media organization is a Shows collection, where each channel is a show and its videos are the episodes, organized in seasons by year.
The plugin interacts with TubeArchivist APIs to fetch videos and channels metadata.

Features

Add metadata for videos (episodes)
Add metadata for channels (shows)
Add images for videos (episodes), ie. thumb images
Add images for channels (shows), ie. thumb, tvart and banner images
Organize videos (episodes) by year (seasons)

Installation

From official repository (recommended)

Go to Dashboard -> Plugins and select the Repositories tab
Add a new repository with the following details:

Repository name: TubeArchivistMetadata
Repository URL: https://github.com/tubearchivist/tubearchivist-jf-plugin/raw/master/manifest.json

Go to the Catalog tab
Find TubeArchivistMetadata in the Metadata section and install it
Restart Jellyfin to apply the changes

From ZIP in GitHub releases

Download the latest available release (tubearchivistmetadata_*.zip) from the repository releases section
Extract the contained files in the plugins/TubeArchivistMetadata folder (you might need to create the folders) of your Jellyfin installation
Restart Jellyfin to apply the changes

Configuration

This plugin requires that you have already an instance of TubeArchivist up and running.

Once installed, you have to configure the following parameters in the plugin configuration:

Collection display name
TubeArchivist instance address
TubeArchivist API key
Overviews length (channels and videos descriptions)
Playback synchronization settings discussed in the Playback synchronization paragraph

Use the plugin

Using the plugin is very simple. Let's start from the beginning:

NOTE: If you are using Docker containers, it is important to mount the TubeArchivist media path into Jellyfin container as read-only, in order to avoid possible operations on the media files that will break TubeArchivist.

Go to Dashboard -> Libraries and add a media library
In the form select Shows as Content type, set a display name for the library and set the TubeArchivist media folder in the Folders section
Scrolling down, uncheck all metadata and image providers except TubeArchivist. (You won't find TubeArchivist in seasons providers, so just disable everything there)
Save and come back to Home, you will see the newly added library. Jellyfin will have executed the metadata fetching for you after the collection creation and then you will see the metadata and the images of channels and videos

Playback synchronization

Starting from v1.3.1 this plugin offers playback progress and watched status bidirectional synchronization, but you can choose to enable only a one way synchronization (Jellyfin->TubeArchivist or TubeArchivist->Jellyfin) too.

Jellyfin->TubeArchivist synchronization

This kind of synchronization is done listening for progress and watched status changes while playing the videos for the specified users.
Furthermore, there is a task that runs at Jellyfin startup to synchronize the whole library.

In the plugin configuration you will find these settings:

In the text field you can specify one Jellyfin username to synchronize data of to TubeArchivist.

TubeArchivist->Jellyfin synchronization

This kind of synchronization is done using a Jellyfin scheduled task that regularly synchronizes data from TubeArchivist API to Jellyfin.