Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Release version CI Status Donate

Jellyfin Youtube Metadata Plugin


Plugin for Jellyfin that retrieves metadata for content from Youtube.


  • Local provider uses the info.json files provided from yt-dlp or similar programs.
  • Remote provider uses yt-dlp to download info.json files.
  • Supports thumbnails of jpg or webp format for both channel and videos
  • Supports the following library types
    • Movies
    • Music Videos
    • Shows
  • Supports ExternalID providing quick links to source of metadata.


  • yt-dlp is required if you are using the remote provider.



You are required to have yt-dlp available on the system or container Jellyfin is running on. The following are examples of how you could do this depending on your setup and are not to be considered an exhaustive list.

Installing from package manager

sudo apt-get install yt-dlp

Installing in a container

$ docker exec -it -u root jellyfin bash
$ curl -L -o /bin/yt-dlp
$ chmod a+rx /bin/yt-dlp
$ apt update && apt install --no-install-recommends --no-install-suggests python3

Building a docker image depending on YT-DLP

FROM linuxserver/jellyfin:nightly
RUN apt-get update && apt-get install -y \
RUN python3 -m pip install -U yt-dlp

Installing From Repository (Recommended)

  1. Go to the Admin Dashboard.
  2. In the left navigation menu, click on Plugins.
  3. In the top menu, click Repositories.
  4. Click the + icon to add a new repository.
  5. Repository Name can be anything.
  6. URL must be
  7. If done correctly you should see a new repository on the page.
  8. In the top menu, navigate to Catalog.
  9. Under the Metadata section click on YoutubeMetadata.
  10. Click Install.
  11. Restart Jellyfin.
  12. On the left navigation menu, click on Plugins.
  13. If successful, you will see YoutubeMetadata with status as Active

Manual Installation (Hard)

  1. Navigate to the releases page.
  2. Download the latest zip file.
  3. Unzip contents into <jellyfin data directory>/plugins/YoutubeMetadata.
  4. Restart Jellyfin.
  5. On the left navigation menu, click on Plugins.
  6. If successful, you will see YoutubeMetadata with status as Active


File Naming Requirements

All media needs to have the ID embeded in the file name within square brackets. The following are valid examples of a channel and video.

  • 3Blue1Brown - NA - 3Blue1Brown_-_Videos [UCYO_jab_esuFRV4b17AJtAw].info.json
  • 3Blue1Brown - 20211023 - A_few_of_the_best_math_explainers_from_this_summer [F3Qixy-r_rQ].mkv

info.json and image files need to have the same file name as the media file. As an example, this would cause a breakage

  • 3Blue1Brown - 20211023 - A_few_of_the_best_math_explainers_from_this_summer [F3Qixy-r_rQ].mkv
  • 3Blue1Brown - 20211023 [F3Qixy-r_rQ].info.json

The proper naming format is the default when using yt-dlp and is also enforced in TheFrenchGhosty's Ultimate YouTube-DL Scripts Collection which I highly recommend.

Enabling Provider

  1. Navigate to your Admin Dashboard.
  2. On the left navigation menu, click Libraries.
  3. Click on Threedots for a supported library type.
  4. Click Manage library.
  5. Click the checkbox next to YoutubeMetadata for each downloader or fetcher you wish to enable. In the image below you can see two enabled. Library Fetchers
  6. Click OK.
  7. Click Scan All Libraries.

Providing Cookies to YT-DLP

Warning your cookie grants access to accounts the cookie is granted for. Please protect this file if you decide to use it. Placing a file named cookies.txt into the <jellyfin data directory>/plugins/YoutubeMetadata plugin directory will enable YT-DLP to start using your cookie.

Build and Installing from source

  1. Clone or download this repository.
  2. Ensure you have .NET Core SDK setup and installed.
  3. Build plugin with following command.
    dotnet publish --configuration Release --output bin
  4. Create folder named YoutubeMetadata in the plugins directory inside your Jellyfin data directory. You can find your directory by going to Dashboard, and noticing the Paths section. Mine is the root folder of the default Metadata directory.
    # mkdir <Jellyfin Data Directory>/plugins/YoutubeMetadata/
  5. Place the resulting files from step 3 in the plugins/YoutubeMetadata folder created in step 4.
    # cp -r bin/*.dll <Jellyfin Data Directory>/plugins/YoutubeMetadata/`
  6. Be sure that the plugin files are owned by your jellyfin user:
    # chown -R jellyfin:jellyfin /var/lib/jellyfin/plugins/YoutubeMetadata/
  7. If performed correctly you will see a plugin named YoutubeMetadata in Admin -> Dashboard -> Advanced -> Plugins.


If this plugin helps you, please consider a donation! You can use my ko-fi link. If you would rather donate in some way not supported yet, let me know how you would like to donate.