Usage

This guide explains how to use Export Trakt 4 Letterboxd to export your Trakt.tv data to a Letterboxd-compatible format.

Export Options

The main script Export_Trakt_4_Letterboxd.sh accepts different options:

./Export_Trakt_4_Letterboxd.sh [option]

Available options are:

• normal (default): Exports rated movies, episodes, history, and watchlist
• initial: Exports only rated and watched movies (recommended for first use)
• complete: Exports all available data and compresses Trakt data

Examples:

# Default option (normal)
./Export_Trakt_4_Letterboxd.sh

# Initial option (recommended for first use)
./Export_Trakt_4_Letterboxd.sh initial

# Complete option (with backup and compression)
./Export_Trakt_4_Letterboxd.sh complete

Generated Files

After running the script, the following files will be generated:

• ./copy/letterboxd_import.csv: CSV file ready to be imported into Letterboxd
• ./logs/[DATE]-Export_Trakt.txt: Log file containing export details
• ./brain_ops/: Directory containing raw data exported from Trakt.tv

With the complete option, additional files will be generated:

• ./backup/[DATE]_trakt-backup.tar.gz: Compressed archive of Trakt data

Importing to Letterboxd

Once you have generated the CSV file, you can import it into Letterboxd:

1. Log in to your Letterboxd account
2. Go to https://letterboxd.com/import/
3. Click on "Choose File" and select the generated letterboxd_import.csv file
4. Click on "Import"

Letterboxd will process your file and import your data. This may take a few minutes depending on the amount of data.

Using with Docker

If you're using Docker, the commands are slightly different:

# With Docker Compose
docker compose exec trakt-export ./Export_Trakt_4_Letterboxd.sh [option]

# With Docker directly
docker exec -it trakt-export ./Export_Trakt_4_Letterboxd.sh [option]

For more information on using Docker, see the Docker page.

Automation with Cron

You can automate exports using cron. This is particularly easy with Docker.

For more information on setting up cron jobs, see the Cron Jobs page.