Letterboxd Bulk Watchlist Importer from CSV

WHAT IT DOES

Letterboxd Bulk Watchlist Importer from CSV solves a common film enthusiast challenge: migrating movie lists from other platforms or spreadsheets into Letterboxd. Letterboxd doesn't provide a native way to bulk import movies to your watchlist from external data sources. This tool lets you upload a CSV file containing movie data (title, year, director, rating, etc.), parses the content, and displays the parsed movies in a scrollable checklist. You select the movies you want to add and click "Import to Watchlist." The tool then processes each selected movie sequentially, opening a new tab to search Letterboxd for the movie, navigating to its page, and clicking the "Watchlist" button to add it. The tool supports matching by title and year to ensure the correct film is added. A preview shows your selection before import, and progress tracking shows each movie as it's processed.

WHERE IT RUNS

This extension panel runs directly inside your browser as an overlay on any Letterboxd page. It works when you're browsing Letterboxd, on your profile, watchlist, or the home page. The tool uses tab automation to interact with Letterboxd's search and watchlist interface. It requires no additional API keys or permissions beyond the BotGentz extension.

HOW TO USE

After installing the BotGentz extension and activating Letterboxd Bulk Watchlist Importer from CSV, navigate to any Letterboxd page. Click the extension icon in your browser toolbar to open the panel. Click the file input and select a CSV file containing your movie list. The tool automatically parses the CSV and displays the movies in a scrollable checklist. Each movie appears with its title, year, director, and rating if available. Use the "Select All" toggle or individually check movies. The preview section shows how many movies are selected. Finally, click "Import to Watchlist." A confirmation dialog appears before the import begins. The tool processes each movie with an 800ms delay, opening new tabs to search and add each movie to your watchlist. Progress tracking shows each movie as it's added. A notification appears when all movies have been processed or if any errors occurred.

TECHNICAL OPERATION — CSV Parsing and Tab-Based Watchlist Addition

This tool combines client-side CSV parsing with tab-based automation for watchlist addition. It first reads the uploaded file using FileReader, then parses the CSV content with a custom parser that handles quoted fields and trims whitespace. The tool auto-detects column mapping by scanning for keywords like "title", "year", "director", and "rating" in the CSV headers, falling back to the first column for titles. For each selected movie, the tool constructs a search URL using Letterboxd's search endpoint (`https://letterboxd.com/s/{query}`), opens it in a new tab, waits for the search results to load, clicks the first result link to navigate to the movie's page, then finds and clicks the "Watchlist" button using selectors like `[data-action="watchlist"]` or `.watchlist-button`. After clicking, the tab is closed and the process moves to the next movie. An 800ms delay between movies prevents UI congestion and allows each operation to complete. The tool handles errors gracefully, logging failed movie titles and continuing with the remaining selections.

THE PANEL

The extension panel is fully draggable and remembers its position per site session. It snaps to the nearest edge of the browser viewport when dragged within 50 pixels of any side. You can collapse the panel to a compact title bar using the minimize button, preserving your selection state. The panel resizes vertically by dragging the bottom edge. Press the Escape key to close the panel instantly without losing your selection. The movie list and preview update in real-time as you load data and select movies.

PLEASE NOTE

This tool requires the free BotGentz extension to function. The script operates by opening tabs and simulating clicks on Letterboxd's interface and does not use Letterboxd's official API. It only processes movies that are loaded from the CSV file. For best results, ensure your CSV has columns like "Title" and "Year" for accurate matching. Letterboxd's UI structure may change over time, which could affect search and watchlist button detection; we monitor and release compatibility updates as needed. The tool does not store, transmit, or log any movie data, CSV content, or user activity. All operations occur locally in your browser session. Adding movies to your watchlist may take time for large lists due to the sequential processing delay. You may notice tabs opening and closing during the import process — this is normal behavior.