Skip to main content

Letterboxd

@jamesakeech/letterboxdv2026.10.15.1· 1mo agoBEHAVIORS
01README

Monitor a single user's Letterboxd film diary via their public RSS feed — one record per logged watch (watched date, star rating, like/rewatch flags, film title/year, TMDB id, poster, review). No credentials required; the feed is a rolling window, so run on a schedule to accumulate history.

02Release Notes

Clarify and shorten the README. Runtime code and model versions are unchanged.

03Behaviors1
@jamesakeech/letterboxdv2026.07.20.1letterboxd.ts

Global Arguments

ArgumentTypeDescription
usernamestringLetterboxd username (the <username> in letterboxd.com/<username>). The
baseUrlstringLetterboxd base URL (no trailing slash)
userAgentstringUser-Agent header sent with the feed request (Letterboxd blocks unknown
fn sync_diary(limit: number, sinceDate?: string)
Fetch the user's Letterboxd RSS feed and record each diary film watch.
ArgumentTypeDescription
limitnumberMax diary watches to record from this pull
sinceDate?stringOnly record watches with watchedDate on/after this YYYY-MM-DD date

Resources

diaryEntry(infinite)— A logged film watch from the user's diary (one record per watch;
04Previous Versions2
2026.07.20.1
2026.07.08.1
05Stats
A
93 / 100
Downloads
32
Archive size
8.2 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License1/2partial

    no SPDX license declared

  • Verified public repository2/2earned
06Platforms
07Labels