Letterboxd
@jamesakeech/letterboxdv2026.07.20.1
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.
02Models
@jamesakeech/letterboxdv2026.07.20.1letterboxd.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| username | string | Letterboxd username (the <username> in letterboxd.com/<username>). The |
| baseUrl | string | Letterboxd base URL (no trailing slash) |
| userAgent | string | User-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.
| Argument | Type | Description |
|---|---|---|
| limit | number | Max diary watches to record from this pull |
| sinceDate? | string | Only 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;
03Previous Versions
2026.07.08.1
04Stats
A
100 / 100
Downloads
2
Archive size
8.9 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
- License declared1/1earned
- Verified public repository2/2earned
05Platforms
06Labels