Letterboxd List Downloader

This project provides a web-based tool for downloading user lists from Letterboxd*.

demo.mp4

Table of Contents

• Usage
• Local Installation

Usage

1. Enter the username/list-name or the direct list URL into the textbox on the main page or use the 'q' argument as a URL parameter.
   • Examples for user and list:
     • fastfingertips/list_name (with q arg)
     • fastfingertips/list/list_name (with q arg)
     • with filter:
       • fastfingertips/list_name/genre/crime (with q arg)
       • fastfingertips/list/list_name/genre/crime (with q arg)
   • Examples for user list URLs (http or https):
     • https://letterboxd.com/fastfingertips/list/list_name (with q arg)
     • https://boxd.it/rSrSc (with q arg)
     • with filter:
       • https://letterboxd.com/fastfingertips/list/list_name/genre/crime (with q arg)
       • https://letterboxd.com/fastfingertips/list/list_name/decade/1990s/genre/crime (with q arg)
       • letterboxd short links do not support filters, so we did not implement this. it seems these are used only for sharing the list.
2. Press Enter.
3. If the list is verified, detailed information about the list will be presented.

Local Installation

You can use the Letterboxd List Downloader without installing anything on your local machine by visiting the web application.

If you prefer to run the Letterboxd List Downloader locally, follow these steps:

1. Clone the Repository:

   git clone https://github.com/FastFingertips/lizard.git

2. Install Dependencies:

   pip install -r requirements.txt

3. Run the Application:

   streamlit run main.py --server.port 8080

Now, you can access the Letterboxd List Downloader locally by opening your web browser and navigating to http://localhost:8080.