Skip to content

Latest commit

 

History

History
76 lines (55 loc) · 3.2 KB

README.md

File metadata and controls

76 lines (55 loc) · 3.2 KB
Raw

Letterboxd-to-IMDb

GitHub stars Donate

Python script to import your Letterboxd movies into IMDb.

How it works:
The script first "visits" all the Letterboxd links in your zip file and gets the corresponding IMDb page. This way, it can be ensured the correct movie is rated.
After that, your cookie is used to authenticate a request to the internal IMDb GraphQL rating API.

Video tutorial on how to use this: https://www.youtube.com/watch?v=KF7cfdUTEgw

Prerequisites

Run the script

  1. Export your Letterboxd ratings and watchlist (How to)
  2. Get the IMDb cookie and save it as "cookie.txt" in the script folder
  3. Install dependencies: pip install -r requirements.txt
  4. Run letterboxd2imdb.py: python letterboxd2imdb.py -f <YOUR ZIP FILE>.zip

Common use cases

Getting the IMDb cookie

Treat this cookie like your password!

  1. Log into your IMDb account
  2. Open Chrome dev tools -> Network
  3. Filter by Fetch/XHR
  4. Refresh the page
  5. Copy the cookie of one of the requests (Right click -> Copy Value)

Example

Common use cases

Transfer your ratings and watchlist:
py letterboxd2imdb.py -f .\letterboxd-user-2022-02-20-16-16-utc.zip -w

Transfer your watched movies with a rating of 5/10:
py letterboxd2imdb.py -f .\letterboxd-user-2022-02-20-16-16-utc.zip -r 5

Command line options

usage: letterboxd2imdb.py [-h] -f ZIPFILE [-p PARALLEL] [-c] [-r RATING] [-w]

Imports your Letterboxd ratings and watchlist into IMDb

required arguments:
  -f ZIPFILE   The exported zip file from letterboxd

options:
  -h, --help   show this help message and exit
  -p PARALLEL  Urls to be processed in parallel (valid: 1 to 20)
  -c           Add this flag to disable the history
  -r RATING    The rating to give watched but unrated movies. By default they are ignored (valid: 1 to 10)
  -w           Add this flag to also transfer your watchlist

-p: Can be used if you want to speed up the process, if you set it too high you might get rate limited. Default: 5
-c: If the history is causing problems, you can add this flag to disable it.
-r: Can be used to rate watched but unrated movies. Because IMDb doesn't have an option to "just watch", a default rating has to be specified
-w: Used to also transfer your watchlist

Advanced usage example: py letterboxd2imdb.py -f .\letterboxd-user-2022-02-20-16-16-utc.zip -p 10 -r 5 -w