nandyalu/trailarr v0.13.0

v0.13.0 - TMDB trailers, setup guide & filter counts

on GitHub

v0.13.0 - September 24, 2026

What's New: ✨

• Trailers now come from the list that TMDB curates, in the language you want — add a TMDB API key in Settings > General, and Trailarr downloads a trailer that the studio published instead of searching YouTube and taking the best match. Radarr reports one trailer id and it is usually English, so a trailer in another language meant turning on Always Search and accepting whatever a search returned. Trailarr now asks TMDB for a trailer in the language your profile asks for, and searches only when there is none — see TMDB. Thanks @Jorman for the request, and for the TMDB queries that showed how! (#511)

• Every media item shows the videos Trailarr can download — the new Known videos list on the media details page shows each video and where it came from: one you chose, the TMDB list, the id from Radarr or Sonarr, or an earlier YouTube search. Trailarr takes the first one that works — see Known videos.

• A video you choose is now kept — paste a YouTube link on the media details page, and that video goes to the top of the list. No task removes it, not even when a download of it fails. Before, an automatic search could replace the link that you set. You can record which language your video is in, so one media item can serve an Italian profile and an English one.

• Pick the language of the trailer — a profile has a new Trailer Language. TMDB lists a trailer per language, and a profile that names one downloads that language or nothing: Trailarr never gives you a German trailer when you asked for Italian. When TMDB has no trailer in your language, Trailarr searches YouTube with your search query and says so in the log. Leave the setting empty, which is the default, and nothing changes — see Trailer Language.

• A new installation gets a setup guide — the first time you open the web page, Trailarr walks you through what it does, your first connection, the optional TMDB API key, and what the first run would download — then you decide when downloads start. Every step can be skipped, and an installation that already has a connection or any media never sees it.

• The filter button counts what it found — the button now reads 2789 / 3746: how many items the filter matched, and how many the page can show. On the Home page this is how much of your library has a trailer. On the Movies and Series pages, select Downloaded or Missing to see the same count for that type — see Filtering. Thanks @jaycedk for the idea and the exact format! (#618)

Other Changes: ⚙️

• Old database backups are deleted — Trailarr copies the database at every start, and kept the newest 30 copies. That limits a count, not a disk: one user found 1.5 GB of backups. Trailarr now keeps 10 backups and deletes any backup more than 30 days old. Set BACKUP_KEEP_COUNT and BACKUP_KEEP_DAYS to change the limits — see Environment variables. The copy from the current start is never deleted, and the update_<version> folders of a direct installation now obey the same limits. Thanks @JacobBrown4 for the report, and for the file sizes that showed the cause! (#681)

• The Health page tells you about the TMDB key — the page lists the key with the rest of your setup, says what Trailarr does without one, and links to the page that says how to get one. It stays grey while no key is set: a key is optional, so the page does not report an issue for it — see Health.

• A failed video no longer blocks the ones behind it — when a download fails, Trailarr tries the next video on the next run and returns to the failed one later. A trailer that YouTube removed used to stop the item from getting any trailer.

• Always Search ignores the TMDB list too — the setting means what it says: no id from any source, a YouTube search every time. If you turned it on to get a trailer in your language, a TMDB key with a Trailer Language does that better, so turn it off and set the language — see Always Search.

• The API has three new endpoints — GET, POST and DELETE on /api/v1/media/{id}/videos read, add and remove the known videos of a media item.

• A series gets a curated trailer for the first time — Sonarr reports no YouTube trailer id, because it takes its metadata from TVDB and TVDB has none, so Trailarr always searched YouTube for a series and took the best match. With a TMDB API key, a series now gets the same curated list as a movie.