How It Works
Get your analytics up and running in three simple steps.
Export
Visit Letterboxd Settings → Data, download your data export as a ZIP file, and extract it to access your CSV files. This contains your complete viewing history, ratings, and watchlist data.
Upload
Drag and drop your extracted CSV files into the analytics dashboard. Upload one or multiple files—we'll automatically validate, merge, and process them. All processing happens locally in your browser.
Explore
Instantly see 18+ interactive charts and statistics analyzing your cinematic identity. Discover patterns in your viewing habits, favorite decades, rating tendencies, and much more—all beautifully visualized.
Understanding Your Data Export
When you export your data from Letterboxd Settings → Data, you'll receive a ZIP file containing your complete viewing history. After extracting the ZIP, you'll find various CSV files and folders organized as follows:
ZIP File Contents:
📄 CSV Files:
comments.csv, diary.csv, profile.csv, ratings.csv, reviews.csv, watched.csv, watchlist.csv
📁 Folders:
deleted/, likes/, lists/, ...
Note: Liked films are stored in the likes/ folder as films.csv
Supported Files for Upload
You can upload any of the following CSV files. We recommend uploading watched.csv or diary.csv for the most complete analytics.
watched.csvEssentialYour complete viewing history with watch dates. This is the foundational file for all analytics.
diary.csvRecommendedIncludes ratings, rewatch markers, and tags. Provides the richest data for detailed analytics.
ratings.csvFilms you've rated with your ratings and rating dates.
watchlist.csvFilms in your watchlist for tracking progress and goals.
likes/films.csvFilms you've marked as favorites (found in the likes folder).
profile.csvYour profile information and account details (optional).
Analytics Overview
Your data transforms into 18+ interactive charts and statistics organized across six analytical categories. Each category reveals different aspects of your cinematic identity.
- 01
Viewing Rhythm
Timeline charts tracking when and how you watch
Viewing TimelineYear-over-Year ComparisonLikes Over Time - 02
Taste & Preference
Rating distributions and preference patterns
Rating DistributionFavorite Rating DistributionDiary Stats - 03
Decades & Eras
Films organized by release decade and era
Films by DecadeTop-Rated DecadesFavorite DecadesRelease by Era - 04
Engagement Ratios
Proportional analysis of rated, liked, and rewatched films
Rated RatioLiked RatioRewatch Ratio - 05
Progress & Goals
Watchlist progress and canon list tracking
Watchlist ProgressCanon ListsWatchlist by Decade - 06
Your Year in Film
Summary statistics and insights for the last complete year
Year in Review StatsMonthly ActivityAnnual Summary
See It In Action
Here's a preview of some key charts you'll see in your analytics dashboard. These examples show mock data—yours will reflect your unique viewing history.
Release Year Distribution
Explore your viewing history across cinema's entire timeline. This interactive chart reveals which eras dominate your taste—with era-based filtering, historical reference lines, and a gradient that makes decades come alive. Notice how the color shifts from classic films to contemporary releases.
Year-over-Year Comparison
Track how your viewing habits evolve over time. This stacked visualization compares your monthly activity across multiple years, revealing patterns like summer slowdowns, holiday binges, or steady growth in your cinematic journey. Each year is color-coded for effortless comparison.
Still have questions?
Get in touch →Frequently
Asked Questions
Troubleshooting
Common Issues
For
Developers
Want to test the upload functionality with real Letterboxd data? Download sample CSV files and try uploading them to see how robust the data handling is.
Sample Data Files
Test the platform with real Letterboxd data export. These CSV files come from an actual Letterboxd account and include all supported file types.
Profile 01: Contemporary Cinema
1,656 watched films spanning modern and classic movies with complete viewing history, comprehensive ratings, extensive watchlist, and marked favorites. Full analytics dashboard with all charts populated with rich data.
Profile 02: Cinema Historian
1,999 watched films spanning silent era to contemporary cinema with comprehensive viewing history, extensive watchlist, detailed ratings across all decades, and complete favorite selections. Recommended for full feature showcase—all analytics fully populate with rich historical context and complete decade breakdowns.
Tips: These files are perfect for testing CSV parsing, error handling, and data validation. Try uploading them one by one, in combinations, or even re-uploading them multiple times to see how the platform handles edge cases.