{"id":18265441,"url":"https://github.com/goodbyteco/letterboxd-watchlist-picker","last_synced_at":"2025-04-04T21:31:46.783Z","repository":{"id":40260367,"uuid":"287876013","full_name":"GoodbyteCo/Letterboxd-Watchlist-Picker","owner":"GoodbyteCo","description":"A simple website that gives you a random film off your Letterboxd watchlist (or any list).","archived":false,"fork":false,"pushed_at":"2023-08-18T22:45:43.000Z","size":1180,"stargazers_count":61,"open_issues_count":11,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-20T19:34:25.813Z","etag":null,"topics":["film","go","letterboxd","movies","watchlist","web-scraping","webapp"],"latest_commit_sha":null,"homepage":"https://watchlistpicker.com/","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GoodbyteCo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"ko_fi":"goodbyte","github":"holopollock"}},"created_at":"2020-08-16T04:53:44.000Z","updated_at":"2025-03-03T16:15:31.000Z","dependencies_parsed_at":"2022-08-17T20:00:23.217Z","dependency_job_id":null,"html_url":"https://github.com/GoodbyteCo/Letterboxd-Watchlist-Picker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GoodbyteCo%2FLetterboxd-Watchlist-Picker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GoodbyteCo%2FLetterboxd-Watchlist-Picker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GoodbyteCo%2FLetterboxd-Watchlist-Picker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GoodbyteCo%2FLetterboxd-Watchlist-Picker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GoodbyteCo","download_url":"https://codeload.github.com/GoodbyteCo/Letterboxd-Watchlist-Picker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247252252,"owners_count":20908652,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["film","go","letterboxd","movies","watchlist","web-scraping","webapp"],"created_at":"2024-11-05T11:18:12.768Z","updated_at":"2025-04-04T21:31:44.653Z","avatar_url":"https://github.com/GoodbyteCo.png","language":"Vue","funding_links":["https://ko-fi.com/goodbyte","https://github.com/sponsors/holopollock"],"categories":[],"sub_categories":[],"readme":"\u003ca href=\"https://github.com/GoodbyteCo/Letterboxd-Watchlist-Picker\"\u003e\n  \u003cimg width=\"230\" alt=\"Watchlist Picker Development\" src=\"public/dev-logo.png\"\u003e\n\u003c/a\u003e\n\n\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n# Letterboxd Watchlist Picker (Web App)\n\n[[Frequently asked questions](#frequently-asked-questions)]\n[[Operational notes](#operational-notes)]\n[[Credits](#credits)]\n\nA simple website that gives you a random film off your watchlist (or any list).\nThe site is built with Vue 2, and deployed at\n[watchlistpicker.com](https://watchlistpicker.com) via Vercel. See also, the\n[Watchlist Picker backend](https://github.com/GoodbyteCo/Watchlist-Picker-Backend)\nand [CLI version](https://github.com/HoloPollock/watchlist-picker).\n\n## Frequently asked questions\n\nIf you have a question that isn't listed below, send us an email at\n[support@goodbyte.ca](mailto:support@goodbyte.ca).\n\n#### How do I get a film?\nEnter your Letterboxd username into the search bar and click \"search\".\n\n#### Why does it say nothing found?\nIf your account is set to private, your watchlist cannot be read. If your account is\npublic, make sure your username is spelt correctly and that there are films in your\nwatchlist. If you are using the Advanced Options, make sure there are already-released\nmovies in your list (released before the current year, and have a date).\n\n#### Why does it give me unreleased movies?\nBy default, Watchlist Picker returns any film in your Letterboxd watchlist. To only see\nreleased films, click on \"Advanced Options\" (located right below the search bar), and\nuncheck \"unreleased films\" from the included results. Note, as we can not actually see\nthe exact date of release, all movies released within the current year are also excluded.\n\n#### How do I get a film from a list?\nEnter the username of the list creator, followed by a \u003ckbd\u003e/\u003c/kbd\u003e and the list\ntitle. For example, you would search through\n[this list](https://letterboxd.com/jack/list/its-someones-favorite-movie/), \nby entering: `jack/its-someones-favorite-movie`\n([see it in action on Watchlist Picker](https://watchlistpicker.com/?u=jack/its-someones-favorite-movie)).\nIf you want to just copy the text straight out of the URL, `jack/list/its-someones-favorite-movie`\nwill work too.\n\n#### Can I get a film from an actor's filmography?\nYes, enter `actor` followed by a \u003ckbd\u003e/\u003c/kbd\u003e then the actor's slug. So for example,\nif you wanted a Brad Pitt film, you would enter `actor/brad-pitt`.\n\n#### Can I get a film from an directors's filmography?\nYes, enter `director` followed by a \u003ckbd\u003e/\u003c/kbd\u003e then the director's slug. So for\nexample, if you wanted a Miranda July film, you would enter `director/miranda-july`.\n\t\n#### How do I search multiple lists at once?\nEnter all of the lists and usernames into the search bar, separated by a space or comma.\n\n#### How do I only show films that are on all of the lists?\nBy default, the lists are combined into a giant pool of movies. To get only movies\nthat appear on all of the lists you've entered (the intersection), click on \"Advanced\nOptions\" (located right below the search bar), and change \"Union\" to \"Intersection\".\n\n#### Why does it say the intersection between the lists is empty?\nThere was not a single movie that appeared on every single one of the lists you entered.\nIf you are certain there should be, make sure all of the lists and usernames are spelt correctly.\n\n#### Can I only search for short films?\nYes, uncheck \"feature-length films\" from the included results in \"Advanced Options\".\n\n#### Can I exclude short films from results?\nYes, uncheck \"short films\" from the included results in \"Advanced Options\".\n\n#### Why does it keep loading a new movie when I refresh the page?\nThe URL of the page contains your search criteria, so you can easily bookmark your\nsearches or share with friends. To reset it, simply click on the logo.\n\n#### How do I turn on dark-mode?\nClick on the toggle switch in the top right corner.\n\n#### How do I turn off dark-mode?\nClick on the toggle switch in the top right corner.\n\n#### Why is the logo spinning?\nIt's like the Letterboxd logo, but a slot machine.\n\n#### Why is the loading bar stuck?\nThe site may have lost connection to the API, or it's just taking longer to search\nthrough the list than anticipated (often the really big lists can take a minute or\ntwo). Try opening the site again in a new tab.\n\n#### How can I support the site?\nIf you wish to help cover operational costs, we have a [ko-fi](https://ko-fi.com/goodbyte).\n\n#### I'm having trouble using the site.\nIf at any point you have issues using the website, please do not hesitate to contact\nus at [support@goodbyte.ca](mailto:support@goodbyte.ca).\n\n\n## Operational notes\n\n[[Building locally](#building-locally)] [[So where are things?](#so-where-are-things)]\n\nThe status of the site can be checked on [the public dashboard](https://watchlistpicker.checklyhq.com/).\n\n### Building locally\n\nClone the project and run `pnpm install`.\n\nThe API uses Vercel functions, so use `vercel dev` to test. However, this requires\na [Vercel](https://vercel.com) account. To test without the films propagating (everything\nwill work, just the picture of the film will not fill in), run:\n\n```\npnpm run dev\n```\n\n### So where are things?\n\n- **Backend:** the backend the site communicates with is located in the `api/` directory,\n  and deployed alongside the rest of the app.\n- **Frontend:** the frontend is written in Vue and located in the `src/` folder.\n- **Assets:** the favicons and occasional image are located in the `public/` directory,\n  while the actual on-site logo is located in `Logo.vue` as an svg. Watchlist Picker\n  does not import any custom typefaces.\n\n## Credits\n\nWatchlist Picker is a [Goodbyte](https://goodbyte.ca) project. Development by\n[Quinn Pollock](https://github.com/HoloPollock) and [Jack Guinane](https://github.com/qjack001).\nMany thanks to Letterboxd for letting us scrape their website. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoodbyteco%2Fletterboxd-watchlist-picker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoodbyteco%2Fletterboxd-watchlist-picker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoodbyteco%2Fletterboxd-watchlist-picker/lists"}