Tube Archivist Jellyfin Integration
Go to file
Simon 3c88c19eb1
add umask to channel folder, fix if folder already exists, #10
2023-10-18 10:13:04 +07:00
.github fix FUNDING file name 2023-07-31 23:45:26 +07:00
app add umask to channel folder, fix if folder already exists, #10 2023-10-18 10:13:04 +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 better debug 2023-07-28 14:39:34 +07:00
LICENSE Initial commit 2023-04-05 23:32:00 +07:00 add umask to channel folder, fix if folder already exists, #10 2023-10-18 10:13:04 +07:00
config.sample.json initial commit, MVP 2023-04-05 23:35:42 +07:00 add docker tag function 2023-08-05 10:26:07 +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

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
  • 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 -it 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

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.

Migration problems

Due to the filesystem change between Tube Archivist v0.3.6 to v0.4.0, this will reset your YouTube videos in Jellyfin and will add them as new again. Unfortunately there is no migration path.

To import an existing Tube Archivist archive created with v0.3.4 or before, there are a few manual steps needed. These issues are fixed with videos and channels indexed with v0.3.5 and later.

Apply these fixes before importing the archive.

Fix folder permissions not owned by the correct user. Navigate to the ta_video_path and run:

sudo chown -R $UID:$GID .

Channel Art
Tube Archivist v0.3.5 adds additional art work to the channel metadata. To trigger an automatic refresh of your old channels open a Python shell within the tubearchivist container:

docker exec -it tubearchivist python

Then execute these lines to trigger a background task for a full metadata refresh for all channels.

from import IndexPaginate
from home.tasks import check_reindex

query = {"query": {"match_all": {}}}
all_channels = IndexPaginate("ta_channel", query).get_results()
reindex = {"channel": [i["channel_id"] for i in all_channels]}