letterboxd-list-radarr

Connect radarr to letterboxd.com lists

Usage

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

Radarr v3

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

If there are any problems with v3, feel free to open an issue.

Radarr v2

1. Configure a new list in radarr, using the Radarr Lists provider.
2. Set Radarr API URL to https://letterbox-list-radarr.herokuapp.com (or your custom one, if you choose self-hosting)
3. Set Path to list to whatever appears in the URL for the list of your choosing after letterboxd.com.

Supported Lists:

• Watchilsts: https://letterboxd.com/screeny05/watchlist/
• Regular Lists: https://letterboxd.com/screeny05/list/jackie-chan-the-definitive-list/
• Watched Movies: https://letterboxd.com/screeny05/films/
• Filmography:
  • Actor: https://letterboxd.com/actor/tom-hanks/
  • Director: https://letterboxd.com/director/alfred-hitchcock/
  • Writer: https://letterboxd.com/writer/charlie-kaufman/
  • Etc.
• Collections: https://letterboxd.com/films/in/halloween-collection/
• Lists tagged by User are not supported. Please use links to the lists themself instead.

Others may be supported, but are not tested, yet.

FAQ

The API always returns Disallowed URL

This means that letterboxd.com does not allow this URL to be crawled per their robots.txt. Your URL probably contains sorting or expensive queries by letterboxd. Check the linked file to ensure your given URL does not match any of the listed paths.

Self-hosting

Using heroku

If you are planning on running this instance for a lot of movies, be sure to set the correct cache-eviction policy for the redis:

heroku redis:maxmemory <name-of-redis-instance> --policy allkeys-lfu

Using docker

git clone [email protected]:screeny05/letterboxd-list-radarr.git
cd letterboxd-list-radarr
npm install
docker-compose up -d

The file redis.conf can be used to configure your own settings for redis.

Your local instance will be available on port 5000 http://localhost:5000

Local & development

You need a working redis-instance, which is used for caching movie- & list-data.

Following environment-params are supported:

• REDIS_URL - A redis connection string to your redis-instance
• PORT - The http-port which the application listens on

1. Clone this repo
2. Make sure you have configured the env-variables
3. npm install
4. npm start