CLI tool to manage your Letterboxd Account
Last updated Jul 2, 2026
25
Stars
1
Forks
1
Issues
+1
Stars/day
Attention Score
51
Topics
Language breakdown
No language data available.
▸ Files
click to expand
README
Letterboxd Stats
Get information about your Letterboxd activity.
Search for actors/directors, analyze your diary/watchlist/rating, check which film you have seen for a particular person. All in your terminal.
Requirements
- Python >= 3.8
- A TMDb API key: to retrieve all the general information for movies/people
- A Letterboxd account: to export your Letterboxd activity through web-scraping.
Installation
Just run:
pip3 install letterboxd_statsConfiguration
It is required to create a config.toml. You can create it in the default config folder (for example, .config/letterboxdstats in Linux) or specify your custom folder with the -c command. For each platform, default config folder follows the structure of the platformdirs package.
# Where you want the .csv file of your Letterboxd activity to be saved.
rootfolder = "~/Documents/letterboxdstats/"
[CLI]
The size of the ASCII art poster printed in your terminal when you check the details of a movie.
Set to 0 to disable
poster_columns = 180 Set ascending order for sorting of tables
ascending = false
[TMDB] apikey = "YOURTMDBAPIKEY"
When you get your lists (-L options), also get all the runtimes from TMDB
and compute the mean of the ratings weighted on the durations. This slows the process.
getlistruntimes = false
[Letterboxd] username = "your-username" password = "your-password"
Options
options:
-h, --help show this help message and exit
-s SEARCH, --search SEARCH
Search for a director
-S SEARCHFILM, --search-film SEARCHFILM
Search for a film.
-d, --download Download letterboxd data from your account
-W, --watchlist show watchlist
-D, --diary show diary
-R, --ratings show ratings
-L, --lists show lists
-l LIMIT, --limit LIMIT
limit the number of items of your wishlist/diary
-c CONFIGFOLDER, --configfolder CONFIG_FOLDER
Specify the folder of your config.toml fileTo do
Note: this is something I do during my free time. Therefore, I can't promise consistent support for this project.
- [x] Use web-scraping to add film to diary/wishlist
- [ ] Check followers' activity.
