https://github.com/tetrax-10/letterboxd-csv-imdb-tmdb-mapper

A Node.js script that adds IMDb and TMDB IDs to a Letterboxd exported CSV file.
https://github.com/tetrax-10/letterboxd-csv-imdb-tmdb-mapper

letterboxd letterboxd-scraping letterboxd-script

Last synced: 2 months ago
JSON representation

A Node.js script that adds IMDb and TMDB IDs to a Letterboxd exported CSV file.

• Host: GitHub
• URL: https://github.com/tetrax-10/letterboxd-csv-imdb-tmdb-mapper
• Owner: Tetrax-10
• License: mit
• Created: 2024-09-11T13:35:07.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2024-09-11T19:47:59.000Z (4 months ago)
• Last Synced: 2024-09-12T05:58:14.693Z (4 months ago)
• Topics: letterboxd, letterboxd-scraping, letterboxd-script
• Language: JavaScript
• Homepage:
• Size: 6.84 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Letterboxd CSV IMDb TMDB Mapper

A Node.js script that adds IMDb and TMDB IDs to a Letterboxd exported CSV file.

# Installation

1. Clone the repository or download it as a zip

```

git clone https://github.com/Tetrax-10/letterboxd-csv-imdb-tmdb-mapper.git

```

2. Install dependencies

```bash

npm install

```

# Usage

1. ### Export Your Letterboxd Data

    Create a `input` folder in the root of this repo and export your Letterboxd data, extract the zip file, and put your `watched.csv` file inside the `input` folder.

2. ### Run the Script to Add IMDb and TMDb IDs

    ```bash

    npm run scrape "watched.csv"

    ```

    After this you can see the output in the `output` folder.

    That's it! 🎉

> [!CAUTION]

> When scraping CSVs that don't have direct film links eg: `diary.csv`, add `nocache` argument. Else the script will fail to scrape the CSV.

>

> ```bash

> npm run scrape "diary.csv" nocache

> ```

#### Additional arguments:

```bash

npm run scrape "watched.csv" imdb b10

```

-   `imdb`: IMDb format output

-   `b10`: convert rating to base 10