Export your Must data

Export your Must watched and wanted movies (and ratings, and reviews, and so on) on a CSV you can then import elsewhere.

At the moment the only officially supported export format is for Letterboxd, to import into other platforms you might have to modify the file (look at some suggestions). Assuming you are importing on Letterboxd the movies will also be added to your diary, if you choose to do so in the Letterboxd importer.

✅ Now working (tested on 12-06-2025)

(there might be issues if there are too many concurrent users)

Installation

Zero installations, just go to the website!

Usage

Click here to enter the site, insert your Must username (without the @!) and click Export. Wait for it to complete the process and the CSV with all your movies and ratings should be automatically downloaded to your device!

Run locally without the hosted site

You can also export directly from this checkout:

node export-must-csv.js your_must_username --out-dir exports

This writes:

• exports/your_must_username_want.csv
• exports/your_must_username_watched.csv
• exports/your_must_username_shows.csv
• exports/your_must_username_seasons.csv

The shows CSV includes show-level TV progress from Must, including entries from Must's shows list for currently watching shows: show title, status, rating, total episode count, watched episode count, first unwatched episode ID, first unwatched episode title, and modified date.

The seasons CSV includes season-level TV progress from Must when the public API returns season records: season title, status, rating, total episode count, episodes watched, first unwatched episode, and modified date. It may be empty if Must only returns show-level progress for your profile.

You can pass a profile URL instead of a bare username:

node export-must-csv.js https://mustapp.com/@your_must_username --out-dir exports

Diary dates default to the website behavior, which logs all movies. To skip watched dates:

node export-must-csv.js your_must_username --diary none --out-dir exports

The exporter uses the same public Must endpoints as the website, so your Must profile needs to be public while exporting.

Where do I find my Must username?

To get your Must username:

• on mobile: go to profile and touch your profile photo to get to the settings, then copy the "Nickname" (not the "Name"!), or share via link and then copy the username without the "@";
• on PC: simply login to https://mustapp.com and copy your username in the address bar without the "@" (ex. johnwick in mustapp.com/@johnwick)

The site doesn't warn you if the user hasn't been found, therefore in the case it doesn't work try to double check the username.

What do I do with the file downloaded?

If you want to import your watched movies on Letterboxd, go here and upload there your downloaded file.

At the moment importing into other platforms is not officially supported, hence uploading the file on other importers might not work. In the case it doesn't get accepted you may want to modify the CSV or extract the IMDB IDs, as those IDs can be used to import movies on almost every platform.

If you want to import your watched movies and reviews on IMDb I suggest using Tampermonkey and the IMDb importer script (I don't own any of this, so please refer to them for any help).

Feature requests

Write feature requests in the issues of this repository, any feedback is appreciated!