Tube Archivist Jellyfin Integration
Go to file
Simon f3661cba45
update base
2024-04-20 01:47:41 +02:00
.github fix FUNDING file name 2023-07-31 23:45:26 +07:00
app Add ability to have a different name for folder (#20) 2024-04-20 06:08:32 +07:00
assets duplicate collection art for standalone 2023-07-28 00:32:27 +07:00
.gitignore update requested condition, add jetbrains editors to gitignore 2023-06-28 14:27:52 +02:00
Dockerfile update base 2024-04-20 01:47:41 +02:00
LICENSE Initial commit 2023-04-05 23:32:00 +07:00 Update (#35) 2024-04-20 06:10:54 +07:00
config.sample.json Add ability to have a different name for folder (#20) 2024-04-20 06:08:32 +07:00 Add ability to have a different name for folder (#20) 2024-04-20 06:08:32 +07:00
docker-compose.yml add docker documentation 2023-07-31 23:38:02 +07:00
requirements.txt bump requirements 2023-08-29 10:03:45 +07:00

📢 Important Announcement: Repository Deprecation and Migration

We want to inform you that we are deprecating this repository, tubearchivist-jf , and moving to an updated repo, tubearchivist-jf-plugin. This decision comes as part of our efforts to streamline our development process and provide a better experience for our users.

The new plugin offers better features, as well as a more futureproof codebase.

Key Dates:

What Does This Mean for You?

  • We strongly suggest not installing this repo as it will stop receiving updates.
  • Transition to the new repo at your earliest convenience.

Tube Archivist Jellyfin Integration

Import your Tube Archivist media folder into Jellyfin

home screenshot

This repo looks for regular contributors. If this is a useful integration, consider improving upon it.

This requires Tube Archivist v0.4.0 or later for API compatibility.

Core functionality

  • Import each YouTube channel as a TV Show
  • Each year will become a Season of that Show
  • Load artwork and additional metadata into Jellyfin

How does that work?

At the core, this links the two APIs together: This first queries the Jellyfin API for YouTube videos for any videos that don't have metadata to then populate the required fields from Tube Archivist. Then as a secondary step this will transfer the artwork.

This doesn't depend on any additional Jellyfin plugins, that is a stand alone solution.

This is a one way sync, syncing metadata from TA to Jellyfin. This syncs in particular:

  • Video title
  • Video description
  • Video date published
  • Channel name
  • Channel description

Setup Jellyfin

Take a look at the example docker-compose.yml provided.

  1. Add the Tube Archivist /youtube folder as a media folder for Jellyfin.

    • IMPORTANT: This needs to be mounted as read only aka ro, otherwise this will mess up Tube Archivist.
  2. Add a new media library to your Jellyfin server for your Tube Archivist videos, required options:

    • Content type: Shows
    • Displayname: YouTube
    • Folder: Root folder for Tube Archivist videos
    • Deactivate all Metadata downloaders
    • Automatically refresh metadata from the internet: Never
    • Deactivate all Image fetchers
  3. Let Jellyfin complete the library scan

    • This works best if Jellyfin has found all media files and Tube Archivist isn't currently downloading.
    • At first, this will add all channels as a Show with a single Season 1.
    • Then this script will populate the metadata.
  4. Backdrops

    • In your Jellyfin installation under > Settings > Display > enable Backdrops for best channel art viewing experience.

Install with Docker

An example configuration is provided in the docker-compose.yml file. Configure these environment variables:

  • TA_URL: Full URL where Tube Archivist is reachable
  • TA_TOKEN: Tube Archivist API token, accessible from the settings page
  • JF_URL: Full URL where Jellyfin is reachable
  • JF_TOKEN: Jellyfin API token
  • JF_FOLDER: Folder override if your folder is not named "YouTube" on your Filesystem.
  • LISTEN_PORT: Optionally change the port where the integration is listening for messages. Defaults to 8001. If you change this, make sure to also change the json link for auto trigger as described below.

Mount the /youtube folder from Tube Archivist also in this container at /youtube to give this integration access to the media archive.

Manual trigger

For an initial import or for other irregular occasions, trigger the library scan from outside the container, e.g.:

docker exec tubearchivist-jf python

Auto trigger

Use the notification functionality of Tube Archivist to automatically trigger a library scan whenever the download task completes in Tube Archivist. For the Start download schedule on your settings page add a json Apprise link to send a push notification to the tubearchivist-jf container on task completion, make sure to specify the port, e.g.:


Install Standalone

  1. Install required libraries for your environment, e.g.
pip install requests
  1. rename/copy config.sample.json to config.json.
  2. configure these keys:
    • ta_video_path: Absolute path of your /youtube folder from Tube Archivist
    • ta_url: Full URL where Tube Archivist is reachable
    • ta_token: Tube Archivist API token, accessible from the settings page
    • jf_url: Full URL where Jellyfin is reachable
    • jf_token: Jellyfin API token
    • jf_folder: Name of the folder where TubeArchivist puts the files into

Then run the script from the main folder with python, e.g.

python app/


You can only have one folder called YouTube in your Jellyfin.

Jellyfin needs to be able to see the temporary season folders created by this extensions. You will see messages like waiting for seasons to be created before you will run into a TimeoutError, if that doesn't happen in a reasonable time frame.

Some ideas for why that is:

  • Your JF busy, too slow or is already refreshing another library and is not picking up the folder in time.
  • JF doesn't have the permissions to see the folder created by the extension.
  • You didn't mount the volumes as expected and JF is looking in the wrong place.