Import and sync IMDb lists to TMDB

1. Make sure you have Node.js installed. You can use Bun.js too.

2. Download this repo.

3. Open a terminal inside import-imdb-lists-to-tmdb folder and run npm install.

4. Rename the file .env.example to .env and replace the placeholders with your api key and write access token.

   Note: You can create a write access token from here with your API Read Access Token.

To Import/Sync your IMDb lists to TMDB, all you have to do is configure the config.json file.

If you want to import a IMDb list into TMDB, Open the config.json file and specify the IMDb list's ID in the imdbId field. Assign null to the tmdbId field. Don't forget to specify a name in the name field.

{
    "name": "Watched Movies",
    "imdbId": "ls540766631",
    "tmdbId": null, // when ID is null it will be imported
    "sortField": null,
    "isReverse": false
}

If you already have a TMDB list that's just out of sync, follow the same procedure. However, instead of assigning null to the tmdbId field, assign the TMDB list's ID to the tmdbId field.

{
    "name": "Watched Movies",
    "imdbId": "ls540766631",
    "tmdbId": "8282880", // when ID is not null it will be synced
    "sortField": null,
    "isReverse": false
}

If your list is private, you can't simply put the IMDb list's ID in the imdbId field due to permission issues. You can overcome this with these two methods:

Just export the private IMDb lists as CSV and put them inside imdb-csv folder and specify the file name in imdbId with .csv extension.

{
    "name": "Watched Movies",
    "imdbId": "Watched Movies.csv", // exported csv file name
    "tmdbId": "8282880",
    "sortField": null,
    "isReverse": false
}

Make sure you are logged in to IMDb on chrome. Then go to chrome://version, copy your Profile Path and paste it next to CHROME_USER_DATA_PATH in .env file. So this script can access your IMDb account.

// It should look like this
CHROME_USER_DATA_PATH=C:/Users/username/AppData/Local/Google/Chrome/User Data

You can sort the IMDb list and then import it to TMDB by specifying a valid field name in the sortField.

valid field names are:

Position | Created | Modified | Title | Title Type | IMDb Rating | Runtime (mins) | Year | Num Votes | Release Date | Directors | Your Rating | Date Rated

Note: numbers fields are sorted in descending order and strings are sorted in ascending order. You can reverse them by making isReverse as true.

Run this command inside import-imdb-lists-to-tmdb folder to import/sync your lists specified in config.json.

npm run sync

To force sync your list (clears all titles inside your TMDB list and imports them freshly)

npm run force-sync