Meta's Nifty Film Fest Scheduler

Your ratings

Letterboxd lets you download your data from Settings → Data → Export your data. Drop the zip in below, or just the ratings.csv from inside it. IMDb exports work too.

Choose your export .zip or .csv — it is read here, not uploaded

No account, no sign-in. The file is read by this page and stays on your device.

Just looking? — 125 invented ratings from a horror-leaning viewer.

Films it couldn't identify, and TMDB lookups

Film credits come from a list bundled with this app. Anything it doesn't recognise can be looked up from TMDB if you paste a free API key — the key stays in this browser and is only used to ask about films, never about you.

Which festival

Schedules are often published days before a festival starts, so this list is updated as they appear. Not seeing yours? Load one from a URL or paste the schedule data.

Add a festival that isn't listed

Festivals publish their schedules days before they start, in whatever shape their ticketing platform uses, so this app reads a plain JSON file instead. Drop one in below and it works immediately — on your device, whether or not it ever gets added here.

Open a festival file a .json file in the format below

Or load one from a web address:

Or paste the data directly:

Making the file

The repository has scripts that build one from a festival's published schedule, and enrich_festival.py fills in credits and posters from TMDB. If you'd rather assemble it by hand, this is the whole format — everything else is optional:

{
  "festival": "Some Fest 2027",
  "days": ["2027-03-04", "2027-03-05"],
  "films": [
    {
      "title": "A Film",
      "year": 2027,
      "runtime": 94,
      "synopsis": "One or two sentences.",
      "section": "Main Competition",
      "kind": "film",
      "entities": {
        "director": ["A Director"],
        "cast": ["An Actor"],
        "keyword": ["revenge", "small town"],
        "genre": ["horror"]
      }
    }
  ],
  "screenings": [
    { "film": "A Film", "date": "2027-03-04", "time": "7:30 PM", "runtime": 94 }
  ]
}

Two things matter: a screening's film has to match a lineup title exactly, and dates are YYYY-MM-DD. Use "kind": "event" for parties, secret screenings and live shows — those get listed but not rated. The more of entities you fill in, the better the recommendations; with none, every film scores the same.

Sharing it

Optional, and only if you want to. A shared festival gets checked against the official schedule before it's added, because a wrong showtime here means someone misses a film.

Load a festival first. Both options download the file for you to attach — a web page can't attach it for you, and nothing is sent anywhere until you send it.

Help make the recommendations better

This is an alpha. The model behind it was trained on an old public dataset of mostly mainstream films, and it's being tested against real film-festival slates — where most titles are premieres nobody has rated yet. More real rating histories make it measurably better, and there's an honest test in the repository that scores how well it predicts ratings it has never seen.

Please only send yours if you've rated at least 30 films. This isn't gatekeeping — it's that smaller histories can't answer the question being asked. The test hides 30% of someone's ratings and checks whether the recommender predicts them. With 20 ratings that means learning from 14 films and being graded on 6, which is mostly luck: measured across hundreds of people, profiles under 30 scored barely better than assuming someone likes everything equally. Sending a small one means handing over your viewing history for no useful result, which isn't a fair trade. Rate more films and come back — it stays useful.

What to send, and what not to

On a computer, sign in and open letterboxd.com/settings/data.
Click Export your data. A .zip downloads.
Open the .zip and take out ratings.csv only.
Send that one file. Please don't send the whole .zip.

ratings.csv holds only the date, film title, film year, a link to the film, and your star rating. Your username, real name, email, location, bio, reviews, diary and watchlist are in other files in that zip, which is exactly why only this one is wanted. If you'd rather not share when you watched things, delete the Date column first — it isn't used. And again: 30 ratings or more, please. Below that your history can't answer the question the test asks, so sending it costs you privacy for nothing.

Meta's Nifty Film Fest Scheduler

Your ratings

Which festival

Making the file

Sharing it

When you're not free

Preferences

Your plan

Take it with you

Help make the recommendations better