Import Lists

Automatically add movies to Luminarr from TMDb, Trakt, your Plex watchlist, and other curated sources. Import lists run on a schedule and add new movies without manual intervention.

Available Sources

Sources

Each source type pulls a different feed of movies. You can add multiple lists from different sources and they all sync independently.

The Movie Database (TMDb)

List Type What it returns Auth required
Popular Most popular movies on TMDb right now API Key
Trending Movies trending over the last week API Key
Upcoming Movies with a theatrical release in the near future API Key
Now Playing Movies currently in theaters API Key
Top Rated Highest-rated movies on TMDb API Key
List A specific TMDb user list by ID API Key
Person All movie credits for a specific actor or director API Key
Collection All movies in a TMDb collection (e.g., a franchise) API Key

Trakt

List Type What it returns Auth required
Popular Most popular movies on Trakt Client ID
Trending Movies being watched right now on Trakt Client ID
Anticipated Most anticipated upcoming movies based on watchlist activity Client ID
Box Office Top 10 weekend box office results Client ID
List Any public or authenticated Trakt list by URL OAuth + Client ID

Other Sources

Source What it returns Auth required
Plex Watchlist Movies on your Plex watchlist Plex Token
MDBList Any MDBList list by URL API Key
Steven Lu Community-curated list of popular movies None
Custom List A JSON or plain-text list of TMDB IDs hosted at any URL None
Configuration

List Settings

Each import list is configured with the following fields. These settings control how movies added by the list are managed once they land in Luminarr.

Field Description Notes
Name Display name for this list Shown in the Import Lists settings page
Enabled Whether this list is included in sync runs Disabled lists are skipped without being deleted
Search on Add Immediately search for a release when a movie is added If disabled, the movie waits for the next RSS sync cycle
Monitor Monitoring state to set on newly added movies Options: Monitored, Unmonitored
Min Availability Minimum release status before searching begins Options: Announced, In Cinemas, Released. Prevents grabbing CAM releases of films still in theaters.
Quality Profile Quality profile assigned to movies added by this list Required. Determines resolution, source, and codec targets
Library Root folder where imported files are placed Required. Must be a configured library path

Import exclusions take precedence. If a movie from an import list matches an entry in your Import Exclusions, it will not be re-added regardless of which list synced it.

How It Works

Sync Process

Import list sync runs on a schedule (default every 24 hours) and also when you manually trigger it from the Settings page.

  1. 1

    Fetch all enabled lists

    Luminarr calls each enabled list's source API in parallel, collecting a set of TMDb IDs.

  2. 2

    Deduplicate and filter

    IDs are merged across all lists and checked against your existing library. Movies already in Luminarr are skipped. Movies matching an import exclusion are skipped.

  3. 3

    Fetch metadata

    For each new TMDB ID, Luminarr fetches full movie metadata from TMDb — title, overview, release date, poster, genres.

  4. 4

    Add to library

    Each new movie is added using the list's configured quality profile, root folder, monitor state, and minimum availability. A movie_added event fires for each addition.

  5. 5

    Search for releases

    If "Search on Add" is enabled for the list, Luminarr immediately kicks off an interactive search for each newly added movie. Otherwise, the movie enters the monitored queue and will be picked up on the next RSS sync.

Lists do not delete movies. Removing a movie from a source list (e.g., your Trakt watchlist) does not delete it from Luminarr. Import lists are additive only.