Configuration

Which libraries to scan, listed live from your server. Leave everything unchecked to scan every library; check specific ones to scope each run to just those. Applies to both movies and TV series — only libraries that actually contain them are useful here.

Runs a Jellyfin library scan immediately after a run downloads a trailer or moves a movie, so the change shows up right away instead of waiting for the next scheduled scan.

Search results longer than this are assumed to be a full movie, compilation, or unrelated video — not a trailer — and rejected.

The minimum acceptable trailer resolution, chosen from 480p (SD) up to 2160p (4K).

Which matters more. Preferred language (default) searches in the item's own language first, the same as any other search (see How It Works) — but the search stops at the first successful download regardless of resolution, so it can settle for a mediocre same-language result without ever trying English, which often has a genuinely higher-quality upload available. Best quality skips the native-language search stage, going straight to English/best-available — prioritizing resolution over language match.

Also re-checks trailers you already have against the resolution and audio preference above, searching for a better replacement if one falls short. The existing file is only ever replaced by a genuine improvement — both are probed and compared after the new attempt completes, so a re-attempt that can't beat it leaves the original untouched.

Off by default: turning it on means re-running the full search/download flow for every under-quality trailer on every run until it clears the bar, not just once — meaningfully more requests to YouTube, and so more exposure to rate limiting, until your library catches up. Worth turning on for a pass or two after a big library import, then switching back off.

Renames the movie file itself to match its resolved title, e.g. Movie Name (Year).ext.

Renames a TV series' own top-level folder to match its resolved title, e.g. Series Name (Year), and its season subfolders to Jellyfin's own canonical Season NN naming (Specials for season 0) — based on Jellyfin's own resolved season number for each (its Season entity's own index, the same reliable matching that already finds the right trailer), not parsed from the subfolder's own name. A release-style folder name (tags, resolution, season ranges, ...) can still resolve to the right trailer via search — Jellyfin's own provider matching is forgiving enough for that — but the folder names themselves are what drive Jellyfin's own poster match in the collection/list view and displayed title, which the search step never touches. Episode files themselves are never renamed or moved.

Jellyfin only recognizes a local trailer file when the movie has its own dedicated folder (jellyfin/jellyfin#10077) — a correctly named trailer sitting in a folder shared by other movies is silently ignored. Three modes:

Also downloads a local theme song (theme.mp3) for each movie/series, looked up on ThemerrDB by TMDb id - the same community-curated database the Themerr-jellyfin plugin uses, so an item only gets a theme song here if Themerr would have offered one too. Only the lookup is shared with Themerr; the download itself goes through this plugin's own yt-dlp pipeline (see How It Works) instead of Themerr's downloader, which fails outright on plenty of videos yt-dlp handles fine.

An item with no TMDb id, no ThemerrDB entry, or not in its own dedicated folder is silently skipped - this never touches an existing theme.mp3, whether user-provided or already downloaded by Themerr.

A Netscape-format cookies.txt, used by yt-dlp for authenticated/ age-restricted YouTube access. Export one with a browser extension like "Get cookies.txt LOCALLY" while signed in to a YouTube account that's passed age verification, then upload it here. Saved immediately on upload, separately from the Save button for everything else.

Minimum wait before each individual yt-dlp request. A large library can add up to many separate requests with no pacing between them, which can trip YouTube's own rate limiting — see rate-limit handling. Lower this only if you're confident it won't happen; 0 disables the delay entirely.

If YouTube rate-limits the session anyway, wait then retry the rest of the run exactly once instead of stopping immediately. See How It Works for the full behavior.

How long to wait before that single retry. Defaults to a bit past YouTube's own stated "up to an hour" ceiling. Only used (and only editable) when Retry once if rate-limited above is on.

Logs what a run would do — what it would search for, download, rename, or move — without actually downloading, renaming, or moving anything. Safe to run any time to preview the effect of a configuration change.

Logs each rejected search candidate's specific reason (title mismatch, duration too long, missing trailer keyword, ...). Off by default since a movie/series needing several fallback searches can generate dozens of these lines, burying what actually matters for a normal run. Turn on when diagnosing why a specific movie/series isn't finding a trailer it should — see Troubleshooting.