Letterboxd lets you download everything you have logged, and Movie Tracker reads that download directly. Your diary, your ratings, the films you have watched, the ones you liked and the ones still on your watchlist all come across in one go.

You do not need to unpack anything or rename a file. Movie Tracker opens the archive itself and works out which file is which.

What gets imported

• Your diary, with the day you watched each film. A rewatch is a separate entry in Letterboxd and stays a separate viewing here.
• Your reviews, kept as a note on the film.
• Your ratings, converted from Letterboxd’s five star scale to the ten point scale Movie Tracker uses. Three and a half stars becomes 7.
• Films you have watched but never wrote a diary entry for. They come in as watched, without a date, because the export does not say when.
• Films you liked, which arrive watched and grouped in a Space called Liked.
• Your watchlist, added but not marked as watched.
• Tags you wrote on diary entries.

One film usually appears in several of those files at once. Movie Tracker gathers them into a single title rather than importing it four times, and where two files disagree the diary wins, because it is the one that knows the day.

What is not imported

• Comments, lists you made, and the reviews you liked. Movie Tracker has no place for them.
• The deleted and orphaned folders, which hold entries Letterboxd itself has set aside.
• Your profile and follower information.

Before you start

Import from Letterboxd first, before you add films by hand. If a film is already in your library, Movie Tracker updates it rather than adding a second copy, but starting with the import saves you the work.

Step 1: download your data from Letterboxd

1. Sign in to Letterboxd on a computer. The export is not available in the mobile app.
2. Go to letterboxd.com/user/exportdata.
3. Letterboxd prepares your data and your browser downloads a .zip file. The name looks like letterboxd-yourname-2026-09-03-08-11-utc.zip.

If you are on an iPhone or iPad, download the file there or send it to yourself and save it in Files. Movie Tracker can pick it up from anywhere the Files app can reach, including iCloud Drive.

Step 2: keep the archive as it is

Do not unzip it, and do not rename the files inside. Movie Tracker tells watched.csv, watchlist.csv and likes/films.csv apart by where they sit in the archive, not by what is in them. Those three files have identical columns and opposite meanings, so a file moved out of its folder is a file the app can no longer read correctly.

Step 3: import into Movie Tracker

1. Open Movie Tracker.
2. Go to Settings, then Import.
3. Tap Choose Files and pick the .zip you downloaded.
4. Movie Tracker recognises it as a Letterboxd export and says so. If it does not, choose Letterboxd from the list yourself.
5. Tap Continue.

During the import

Movie Tracker looks up every film in its catalog by title and year. Letterboxd’s export does not carry a catalog number, so this is the only way to identify a film, and it is why the year matters: two films can share a title, and the year is what tells them apart.

When more than one film matches, Movie Tracker shows you the choices and picks the most likely one for you. You can change any of them on the review screen before anything is written to your library.

The progress counts titles, not rows. A film with twelve diary entries moves the number once.

Titles that could not be matched

When the import finishes you get a summary, and any film the catalog could not place is listed there by the name your file gave it. This usually happens with very obscure titles, or where Letterboxd and the catalog spell a name differently.

You can save the whole summary as a PDF, along with a spreadsheet of the rows that need correcting, so you can add those few films by hand afterwards without hunting through your library to find which ones are missing.

If something goes wrong

• The app says it does not recognise the file. Check that you picked the .zip and not a single .csv pulled out of it. A lone watched.csv has no folder around it, so the app cannot tell it from a watchlist.
• Nothing was imported. If you extracted the archive and re-zipped it, the folder structure may have changed. Download a fresh copy from Letterboxd and use it untouched.
• A film came in as watched when it should be on the watchlist. A film that appears in both files is treated as watched, because in Letterboxd it was.