Skip to content

Sources

Julien Hoffmann edited this page May 18, 2026 · 1 revision

Sources

watchlist2dvr can gather movies from several source types. Pick the one that matches how you already manage your watchlist.

IMDb auto-download

This is the most convenient option for personal IMDb watchlists and ratings. It downloads CSV exports directly from IMDb using your session cookie.

sources:
  - type: imdb_auto
    user_id: "ur12345678"
    cookie: "YOUR_AT_MAIN_COOKIE_VALUE"
    lists:
      - watchlist
      - ratings
    min_rating: 1

Notes:

  • user_id is the urXXXXXXX part of your IMDb profile URL.
  • cookie must be the value of IMDb's at-main cookie.
  • The cookie expires when you log out of IMDb.
  • The Sources tab in the web dashboard shows fetch status and provides a refresh action.

IMDb public lists

Use this when you want to import public IMDb charts or public user lists without logging in.

sources:
  - type: imdb_public_lists
    lists:
      - https://www.imdb.com/chart/top/
      - https://www.imdb.com/chart/popular/
      - https://www.imdb.com/list/ls000024621/

Notes:

  • No account is required.
  • IMDb sometimes returns HTTP 202 challenge pages. If that happens, add the extra cookies from your browser session.

IMDb manual CSV

Use exported IMDb CSVs when you prefer to manage the files yourself.

sources:
  - type: imdb_csv
    path: /data
    min_rating: 5

Notes:

  • Drop the exported CSV files into the configured path.
  • The source auto-detects watchlist and ratings files from the headers.

TMDB lists

Use TMDB when you want franchise collections, custom lists, or curated endpoints.

sources:
  - type: tmdb_lists
    lists:
      - "collection:9485"
      - "collection:645"
      - "list:12179"
      - "top_rated"
    pages: 3

Notes:

  • TMDB uses the API key from the main tmdb config block.
  • Supported named endpoints include popular, top_rated, now_playing, and upcoming.

Trakt

Trakt is supported for users who already keep movie lists there.

sources:
  - type: trakt
    client_id: "YOUR_TRAKT_CLIENT_ID"
    client_secret: "YOUR_TRAKT_CLIENT_SECRET"
    username: "YOUR_TRAKT_USERNAME"

Choosing a source

  • Use imdb_auto if you want the least manual work.
  • Use imdb_public_lists if you only need public lists.
  • Use imdb_csv if you already export CSVs.
  • Use tmdb_lists if you want collection-driven curation.
  • Use trakt if Trakt is your primary list manager.

Clone this wiki locally