LePrAn takes your Letterboxd export data and turns it into actual statistics. The free version of Letterboxd itself doesn't give you much in the way of analytics, so this tool aims to fill that gap by pulling data from the TMDB API.
Film stats: Breakdowns by country, language, genre, director, actor, and decade. Per-film budget and box office rankings, plus budget range groupings. Total watch time in hours and days.
Diary analytics: See which days of the week, months, and years you watched the most films.
Watchlist: Optional import of your Letterboxd watchlist. Toggle between watched and watchlist views with separate stats.
Snapshots: Save your entire analysis as a JSON file and reload it later without re-scraping.
Theme toggle: Dark (default) and light themes. Switch with the button in the top-right corner. Your choice is remembered.
- Run
python lepran.py - If it's your first time running this specific version of LePrAn, enter your TMDB API key. It's free and you can get one here. The key is saved to
cfg/.env. - Click "Analyze Letterboxd Folder" and pick your Letterboxd export directory (the extracted .zip file). It needs
watched.csvanddiary.csvat minimum, whilewatchlist.csvis optional: by default, it gets imported too, so uncheck that option if you don't want it. - Wait some time (usually a few minutes) for the analysis to complete.
- Save a snapshot (full JSON state) so you can load it later without re-analyzing the data.
build.batRuns PyInstaller and puts a single executable in dist/.