SensCritique2Letterboxd (s2l) 🍿📊

A script to export your movies from SensCritique to Letterboxd.

(It also works for private members!)

Supports: watched items (with ratings, watched date, reviews) and watchlist

Installation

Pip

Install the package with:

pip install s2l

Usage

Argument	Type	Default	Description
--interactive/-i	bool	False	Interactive mode
--username	str	None	Username (unused if interactive mode)
--add_tv	bool	False	Optional: Add TV shows (unused if interactive mode)
--add_reviews	bool	False	Optional: Add reviews (unused if interactive mode)
--watchlist_only	bool	False	Optional: Export watchlist only (unused if interactive mode)
--user_agent	str	"Mozilla/5.0"	Optional: User agent to use when request
--delay	float	5	Optional: Number of seconds to wait between each batch download to avoid rate limit (decrease for a faster execution, increase to make sure you avoid rate limit)

🌟 New feature (+0.2.0): interactive mode

s2l -i

CLI

Please replace every {USERNAME} with your username.

Watched

To export your movies:

s2l --username {USERNAME} --output movies.csv

If you also want to add your TV shows, please run:

s2l --username {USERNAME} --output movies.csv --add_tv

Finally if you want add your reviews:

s2l --username {USERNAME} --output movies.csv --add_reviews

Watchlist

To export the movies you want to watch (named "Watchlist" on Letterboxd):

s2l --username {USERNAME} --output watchlist.csv --watchlist_only

And import your CSV ✨.

Development

You can spawn a shell with all dependencies with the following method

uv

uv venv

Nix

nix-shell