Jellyfin Enricherr

Troubleshooting

Start with the plugin's own log file: <plugin data folder>/enricherr.log. It has everything below in more detail than Jellyfin's main server log.

A movie/series isn't getting a trailer

  1. Turn on Verbose logging and re-run — this shows the specific reason every rejected search candidate failed (title mismatch, duration, missing trailer keyword), instead of just "no suitable trailer found".
  2. Check the media file's extension is recognized as a valid video file. Uncommon or very old containers may not be — see the log for a line like Skipping "Title": "Not a video file (extension: .xyz)". If you hit this on a legitimate video file, open an issue with the extension.
  3. Check the file isn't being treated as a sample, extra, or existing trailer — files named/placed like one are deliberately skipped.
  4. For an obscure or foreign-language title, the search itself may simply not find a matching official-looking trailer on YouTube. This isn't something the plugin can force.

Trailers are downloading, but at low resolution

Two separate causes, both explained on How It Works:

Age-restricted videos fail with "Sign in to confirm your age"

Upload a cookies file from a YouTube account that's passed age verification. This is a different, unrelated gate from the PO-token quality issue above — cookies fix this one specifically.

A run stopped early / "rate-limited"

See How It Works: rate-limit handling for exactly what happens and why. If it keeps happening on a large library even with the retry, try increasing Delay between requests.

A movie is skipped: "not in its own dedicated folder"

Jellyfin only recognizes a local trailer file when the movie has its own dedicated folder — a correctly named trailer sitting in a folder shared by other movies is silently ignored (jellyfin/jellyfin#10077). Rather than download a trailer Jellyfin could never show, the plugin skips a movie entirely when it isn't already in its own folder and Migrate movies into their own folder is off — logged as a warning naming the movie. Turn that setting on, or move the movie into its own folder manually. TV series don't have this problem — a series always already has its own folder.

If a trailer was downloaded (folder migration was on, or the movie already had its own folder) and Jellyfin still isn't showing it, trigger a library scan (or turn on Trigger a library scan after changes so future runs do this automatically).

A movie isn't getting a theme song

Check in order:

  1. Is Fetch theme songs actually on?
  2. Does the movie have a TMDb id? Series and movies matched purely by folder name/local metadata without an online TMDb match won't have one.
  3. Is the movie in its own dedicated folder? Unlike trailers, a theme song is only fetched once a movie is confirmed to have one, since theme.mp3 is a fixed filename that would otherwise get shared (and misattributed) across every movie in the same folder — see How It Works: theme songs. Turn on Migrate movies into their own folder. TV series don't have this restriction, they always already have their own folder.
  4. Does ThemerrDB actually have an entry for this item? It's community-curated, not exhaustive - you can check directly at https://app.lizardbyte.dev/ThemerrDB/movies/themoviedb/<tmdbId>.json (or tv_shows for a series). If there's nothing there, there's nothing this plugin can fetch; ThemerrDB's own contribution process is the way to add one.

Provisioning fails ("Could not automatically provision yt-dlp")

The plugin downloads yt-dlp/deno from their GitHub releases on first use — this needs outbound internet access from wherever the Jellyfin server process actually runs. Check the server (or its container) can reach github.com.

Still stuck?

Open an issue on GitHub with the relevant section of enricherr.log (with Verbose logging on if it's a matching/filtering question).