Repository navigation
Sources
Julien Hoffmann edited this page May 18, 2026
·
1 revision
watchlist2dvr can gather movies from several source types. Pick the one that matches how you already manage your watchlist.
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: 1Notes:
-
user_idis theurXXXXXXXpart of your IMDb profile URL. -
cookiemust be the value of IMDb'sat-maincookie. - The cookie expires when you log out of IMDb.
- The Sources tab in the web dashboard shows fetch status and provides a refresh action.
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.
Use exported IMDb CSVs when you prefer to manage the files yourself.
sources:
- type: imdb_csv
path: /data
min_rating: 5Notes:
- Drop the exported CSV files into the configured path.
- The source auto-detects watchlist and ratings files from the headers.
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: 3Notes:
- TMDB uses the API key from the main
tmdbconfig block. - Supported named endpoints include
popular,top_rated,now_playing, andupcoming.
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"- Use
imdb_autoif you want the least manual work. - Use
imdb_public_listsif you only need public lists. - Use
imdb_csvif you already export CSVs. - Use
tmdb_listsif you want collection-driven curation. - Use
traktif Trakt is your primary list manager.