selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

letterboxd-list-radarr logo

Self-host letterboxd-list-radarr

Bridge Letterboxd lists to Radarr for movie automation

ReleaseOpen SourceMIT
Updatedlast month
LanguageTypescript
Setup difficultyModerate
Stars
533
Port
5000 (HTTP API)
Requires
Redis
Docker
screeny05/letterboxd-list-radarr
Install with Docker Compose

What is letterboxd-list-radarr?

letterboxd-list-radarr acts as a bridge between Letterboxd and Radarr, exposing Letterboxd lists as custom list endpoints that Radarr can consume. It supports watchlists, regular lists, watched films, reviews, filmographies (actor, director, writer), collections, popular movies, and studio pages. The service is written in Node.js and uses Redis for caching movie and list data. Users can self-host via Docker (with a pre-built multi-arch image), deploy to Render or Heroku with one-click buttons, or run locally with npm. Configuration is done through environment variables (REDIS_URL, PORT, LOG_LEVEL, USER_AGENT) and query parameters (limit, errorOnEmpty). The hosted instance on Render has been suspended by the owner, making self-hosting the primary option. No authentication is built into the service itself; it is meant to be used within a trusted network or behind a reverse proxy.

letterboxd-list-radarr alternatives

Should you self-host letterboxd-list-radarr?

letterboxd-list-radarr scores 51/100 on selfhost.directory (how scoring works) and ranks #66 of 142 in Media Management. It has 533 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Sonarr (81/100, 17 486 stars). It scores higher overall, so compare the two before you pick. See letterboxd-list-radarr vs Sonarr side by side.

Features

  • Collection support
  • Custom list support
  • Empty list handling
  • Filmography support
  • Letterboxd list synchronization
  • One-click deploy to Render/Heroku
  • Popular movies listLimited to 10 pages / 720 movies per Letterboxd robots.txt
  • Result limiting
  • Studio page supportOnly default page supported due to Cloudflare protection
  • Watched films sync
  • Watchlist support

letterboxd-list-radarr README

letterboxd-list-radarr

Connect radarr to letterboxd.com lists

Usage

This service is hosted on render. That way you don't have to run the service yourself (but you can, see below).

Radarr v3 and up
  1. Configure a new list in radarr, using the Custom Lists provider.
  2. Set List URL to https://letterboxd-list-radarr.onrender.com followed by the path to your list in letterboxd. For example: https://letterboxd-list-radarr.onrender.com/screeny05/list/jackie-chan-the-definitive-list/
  3. Configure the rest of the settings to your liking
  4. Test & Save.

How to install letterboxd-list-radarr

Install letterboxd-list-radarr with Docker Compose

Docker and Docker Compose
Environment variables
REDIS_URL, PORT, LOG_LEVEL, USER_AGENT

version: "3.8" services: web: image: screeny05/letterboxd-list-radarr:latest ports: - 5000:5000 environment: - REDIS_URL=redis://redis:6379 depends_on: - redis redis: image: redis:6.0

Pre-built multi-arch image from Docker Hub

How to configure letterboxd-list-radarr

  • REDIS_URLRedis connection string for caching movie and list data

    values: Redis connection string format

  • PORT5000HTTP port the application listens on

    values: Any valid port number

  • LOG_LEVELinfoLog verbosity level

    values: debug, info, etc.

  • USER_AGENTCustom user-agent string for requests

    values: Any string

  • limitReturn only a maximum number of movies (query parameter)

    values: Integer

FAQ

The API always returns 'Disallowed URL according to robots.txt'

This means Letterboxd does not allow the URL to be crawled per their robots.txt. The URL likely contains sorting or expensive queries. Check Letterboxd's robots.txt to ensure your URL does not match any disallowed paths.

More in Media Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…