Skip to content

About

🎬 A privacy-friendly, client-side Letterboxd stats generator & annual story review. Uncover your signature directors, screen hours, TV series, and interactive GraphEd Wrapped β€” powered by TMDB.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

13 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

LBXD Stats Generator Logo

LBXD Stats Generator β€” Cinema Stats & Annual GraphEd

Your cinematic life analyzed with the visual atmosphere, precision, and soul of Letterboxd.

Platform Privacy React TMDB License


πŸ“½οΈ Overview

LBXD Stats Generator is a fast, client-side web application designed to bring your Letterboxd movie and series history to life. Simply import your official Letterboxd ZIP data export to unlock deep viewing analytics, director and actor filmographies with high-resolution portraits, television series classification, and an interactive editorial slide deck (Annual GraphEd).

Built from the ground up to honor Letterboxd's signature dark aesthetic, typography, and color palette.


✨ What It Has (Key Features)

πŸ”’ Letterboxd Export Data & Privacy

  • Your data comes from Letterboxd: LBXD Stats Generator reads the ZIP/CSV export that you download from your own Letterboxd account. It does not connect to your account and never asks for your Letterboxd password.
  • Processed in your browser: The exported diary, ratings, reviews, profile and watchlist are decompressed and analyzed in the browser using JSZip and PapaParse.
  • Not stored by LBXD Stats Generator: The project has no backend, user database or cloud sync. We do not upload, retain or sell your personal Letterboxd data. Refreshing or closing the page clears the in-memory session.
  • External metadata requests: To display posters and film metadata, LBXD Stats Generator sends title and release-year searches to TMDB. Your diary, ratings, reviews, profile and watch history are not sent to TMDB.
  • Your responsibility: The downloaded Letterboxd ZIP remains under your control. Store or delete that file according to your own preferences.

πŸ“Š Deep Cinema Statistics & Viewing Records

  • Core KPIs: Total unique titles, logged viewings, rewatch tally, personal star average, and estimated total watch time (in hours and days).
  • Viewing Streaks: Automatic detection of your longest consecutive daily cinema streak and single-day viewing records.
  • Viewing Habits: Day-of-the-week preferences (e.g., Sunday cinephile index) and monthly viewing rhythm.
  • Rating Distribution: Complete histogram visualization across all half-star ratings (from 0.5β˜… to 5.0β˜…).
  • Yearly Viewing Activity: Historical timeline of your cinema activity across the years.
  • Year Filter & Search: Filter all statistics by any specific year or search instantly.

🎬 Filmmakers & Cast Hub (TMDB Powered)

  • High-Resolution Portraits: Direct integration with The Movie Database (TMDB) API for director, actor, and actress portraits.
  • Top Rankings: Ranked leaders by titles watched and highest personal star average (with minimum viewing thresholds).
  • Person Modals: Click on any director, actor, or actress to view their bio, birthdate, birthplace, and your personal filmography of their works sorted by your rating.
  • Actor/Actress Search: Instant real-time search across all directors, actors, and actresses in your cinema history.

🎞️ Unified Film Catalogue & TMDB Matching

  • Year-aware matching: Letterboxd's release year is checked against TMDB release dates before metadata is shown, preventing titles such as Carrie or Obsession from resolving to the wrong work.
  • Films and series in one catalogue: Series are displayed alongside films without a TV badge; their TMDB seasons and episode data are still retained internally.
  • Manual correction: The detail modal includes "Cambiar obra", which searches TMDB by title and year so an ambiguous result can be corrected without re-importing the export.

✍️ Rich Review Formatting (HTML Support)

  • Rendered HTML Tags: Formats Letterboxd reviews preserving <b>, <strong>, <i>, <em>, <p>, <a>, and <blockquote> styling rather than displaying raw code.

✨ Annual GraphEd (Cinematic Story Mode)

  • Interactive Slideshow: An editorial, Letterboxd Year-in-Review / Wrapped-style presentation.
  • Curated Slides:
    • Slide 0: Year intro & total cinema hours.
    • Slide 1: Your official Film of the Year.
    • Slide 2: Top Runner-Ups and highest-rated gems.
    • Slide 3: How your year started vs. how it ended.
    • Slide 4: Most-watched directors with TMDB portraits.
    • Slide 5: Most-frequent actors and screen stars.
    • Slide 6: Most-rewatched comfort films.
    • Slide 7: Viewing rhythm and sacred movie days.
    • Slide 8: The Grand Finale wrap-up summary.

🍿 Instant Offline Demo Mode

  • Test the application instantly with 1 click using an authentic curated sample dataset (featuring Christopher Nolan, Denis Villeneuve, Bong Joon-ho, Hayao Miyazaki, and more) without needing an export file.

🚫 What It Does Not Have (Scope & Limitations)

To maintain privacy, lightness, and security, LBXD Stats Generator deliberately avoids certain features:

Limitation Reason & Context
No Cloud Sync / Database LBXD Stats Generator has no backend or private server that stores your export. Your Letterboxd data is processed in the browser and kept only in the current in-memory session.
No Direct Letterboxd Account Write Letterboxd does not provide a public write API for standard members. The app operates as an analysis layer on exported data.
No Heavy Server Dependencies Pure client-side static application. No Node.js backend or database server is required to run it in production.
No Dark/Light Mode Toggle Locked exclusively in dark mode (#14181C) to preserve the authentic, immersive Letterboxd cinematic contrast.

πŸš€ Quick Start Guide

How to Get Your Letterboxd Export

  1. Log into your account on letterboxd.com.
  2. Go to Settings (/settings/).
  3. Click on the Data tab in the top navigation.
  4. Click the green button: Export Your Data.
  5. Save the resulting .zip file (do not unzip it).

Running the App Locally

No build process or NPM installation is required.

# Clone the repository
git clone https://github.com/your-username/LBXD_StatsGenerator.git
cd LBXD_StatsGenerator

# Open index.html directly in your browser, or serve with any static server:
npx serve .
# or
python -m http.server 8080
  1. Open http://localhost:8080 (or double-click index.html).
  2. Drag & drop your .zip file into the dropzone (or click "Load Demo" to explore immediately).
  3. Enjoy your cinematic dashboard!

πŸ› οΈ Tech Stack & Architecture

  • Frontend Core: Vanilla React 18 (via UMD) + htm (JSX-like template literals in standard JavaScript with zero build step).
  • ZIP Decompression: JSZip for asynchronous in-memory extraction of CSV tables.
  • CSV Parsing: PapaParse with RFC 4180 compliance, header detection, and Unicode BOM handling.
  • Metadata API: The Movie Database (TMDB) API v3 for high-res artwork, cast, directors, and runtimes.
  • Styling: Vanilla CSS3 Custom Properties, Responsive Grid, Flexbox, and CSS animations.
  • Typography: Google Fonts (Fraunces serif & Inter sans-serif).

πŸ“œ Credits & Attributions

  • Inspiration: Designed with utmost admiration for Letterboxd, the best social network for film lovers.
  • Film Metadata & Posters: Artwork and filmography data provided by The Movie Database (TMDB).

    This product uses the TMDB API but is not endorsed or certified by TMDB.

  • Open Source Libraries:
    • React & React-DOM
    • htm by Developit
    • JSZip
    • PapaParse

πŸ“„ License

Distributed under the MIT License. See LICENSE for details.


Made with ❀️ for cinema lovers and film buffs around the world.

About

🎬 A privacy-friendly, client-side Letterboxd stats generator & annual story review. Uncover your signature directors, screen hours, TV series, and interactive GraphEd Wrapped β€” powered by TMDB.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Contributors

Languages