KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

letterboxd-list-radarr

★ 513 Open GitHub ↗

Connect radarr to letterboxd.com lists

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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.

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://letterboxd-list-radarr.onrender.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:

- Watchlists: 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/
- Popular Movies: https://letterboxd.com/films/popular/
 - Note that neither filtering nor sorting is allowed according to the robots.txt. So URLs like /films/popular/genre/action, /films/popular/decade/2020s /films/by/release, etc. are not supported
 - This list is limited to 10 pages, so a maximum of 720 movies are returned. You can limit this number with the `limit`-option
- Lists tagged by User are not supported. Please use links to the lists themself instead.

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

### Supported options

This is a list of all options you can provide to this scraper, You can set them by attaching a get-parameter to the URL like this:

`/actor/tom-hanks/?<key>=<value>`

Where `key` is the name of the option and `value` is the value you want to provide.

The following options are currently supported:

-   `limit` - Return only a maximum number of movies. This is useful for very large lists like /films/popular/
-   `errorOnEmpty` - The API will return a 404 error if the list is empty. If set to `false`, the API will return an empty list instead. Defaults to `true`.

## FAQ

### The API always returns `Disallowed URL according to robots.txt`

This means that letterboxd.com does not allow this URL to be crawled per their [robots.txt](https://letterboxd.com/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 render

[![Deploy to Render](https://render.com/images/deploy-to-render-button.svg)](https://render.com/deploy)

It might take a few minutes after deploying to render, before the instance becomes available.

Be aware that render currently has a [free limit](https://render.com/docs/free) of 750h/month. That's exactly enough to run this single service for the whole month.

### Using heroku

[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy)

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

#### Pre-built docker-image

You will get the newest image by pulling `screeny05/letterboxd-list-radarr:latest`. The image is available for both x86-64 and arm64.

Here is an example of how to use the image with docker-compose:

```
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
```

For optimal configuration of redis, please check out the [redis.conf](redis.conf) file in this repository.

#### Building it yourself

```
git clone git@github.com: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. It comes with a memory-limit of 256mb by default. You might want to increase that based on your usage.

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](https://github.com/ServiceStack/ServiceStack.Redis#redis-connection-strings) to your redis-instance
-   `PORT` - The http-port which the application listens on
-   `LOG_LEVEL` - Set to `debug` for more info. Defaults to `info`
-   `USER_AGENT` - Allows you to set your own user-agent string

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

letterboxd-list-radarr

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README