![Watchlist Picker Development](public/dev-logo.png)
[Frequently asked questions] [Operational notes] [Credits]
This is a fork of the original Watchlist Picker, which was built by Goodbyte. My wife and I wanted more suspense, so I very hastily updated this to pull 10 random movies from Letterboxd and select one via pachinko/plinko machine. I also hardcoded our two movie lists as buttons, but this could be changed later to pull from a URL hash so these shortcut buttons can be bookmarked.
A simple website that gives you a random film off your watchlist (or any list). The site is built with Vue 2, and deployed at watchlistpicker.com via Vercel. See also, the Watchlist Picker backend and CLI version.
If you have a question that isn't listed below, send us an email at [email protected].
Enter your Letterboxd username into the search bar and click "search".
If your account is set to private, your watchlist cannot be read. If your account is public, make sure your username is spelt correctly and that there are films in your watchlist. If you are using the Advanced Options, make sure there are already-released movies in your list (released before the current year, and have a date).
By default, Watchlist Picker returns any film in your Letterboxd watchlist. To only see released films, click on "Advanced Options" (located right below the search bar), and uncheck "unreleased films" from the included results. Note, as we can not actually see the exact date of release, all movies released within the current year are also excluded.
Enter the username of the list creator, followed by a / and the list
title. For example, you would search through
this list,
by entering: jack/its-someones-favorite-movie
(see it in action on Watchlist Picker).
If you want to just copy the text straight out of the URL, jack/list/its-someones-favorite-movie
will work too.
Yes, enter actor
followed by a / then the actor's slug. So for example,
if you wanted a Brad Pitt film, you would enter actor/brad-pitt
.
Yes, enter director
followed by a / then the director's slug. So for
example, if you wanted a Miranda July film, you would enter director/miranda-july
.
Enter all of the lists and usernames into the search bar, separated by a space or comma.
By default, the lists are combined into a giant pool of movies. To get only movies that appear on all of the lists you've entered (the intersection), click on "Advanced Options" (located right below the search bar), and change "Union" to "Intersection".
There was not a single movie that appeared on every single one of the lists you entered. If you are certain there should be, make sure all of the lists and usernames are spelt correctly.
Yes, uncheck "feature-length films" from the included results in "Advanced Options".
Yes, uncheck "short films" from the included results in "Advanced Options".
The URL of the page contains your search criteria, so you can easily bookmark your searches or share with friends. To reset it, simply click on the logo.
Click on the toggle switch in the top right corner.
Click on the toggle switch in the top right corner.
It's like the Letterboxd logo, but a slot machine.
The site may have lost connection to the API, or it's just taking longer to search through the list than anticipated (often the really big lists can take a minute or two). Try opening the site again in a new tab.
If you wish to help cover operational costs, we have a ko-fi.
If at any point you have issues using the website, please do not hesitate to contact us at [email protected].
[Building locally] [So where are things?]
The status of the site can be checked on the public dashboard.
Clone the project and run pnpm install
.
The API uses Vercel functions, so use vercel dev
to test. However, this requires
a Vercel account. To test without the films propagating (everything
will work, just the picture of the film will not fill in), run:
pnpm run dev
- Backend: the backend the site communicates with is located in the
api/
directory, and deployed alongside the rest of the app. - Frontend: the frontend is written in Vue and located in the
src/
folder. - Assets: the favicons and occasional image are located in the
public/
directory, while the actual on-site logo is located inLogo.vue
as an svg. Watchlist Picker does not import any custom typefaces.
Watchlist Picker is a Goodbyte project. Development by Quinn Pollock and Jack Guinane. Many thanks to Letterboxd for letting us scrape their website.