# Imdbarr

Imdbarr is a lightweight API that converts your IMDb watchlist or any public IMDb list into the format expected by Sonarr's Custom List feature, giving self-hosters a direct way to sync IMDb lists into Sonarr. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2918/imdbarr

## Description

Imdbarr is a lightweight API that converts your IMDb watchlist or any public IMDb list into the format expected by Sonarr's Custom List feature, giving self-hosters a direct way to sync IMDb lists into Sonarr.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

30/100 (Low), based on 4 of 5 factors.
- Maintained: 0 (GitHub repository is archived)
- Popular: 21 (10 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 95 (no serious findings, CI, tests)

## Links

- GitHub: https://github.com/skulltrail/imdbarr
- Unraid: https://ca.unraid.net/apps/imdbarr-1wh5uwf1uufbvn?q=imdbarr

## Common questions

### Does Imdbarr need a database?

No, it fetches directly from IMDb and does not require a database. It caches TMDB lookups for 24 hours.

### What key is required in .env?

Set TMDB_API_KEY to a free TMDB API key. The README says to request it as Developer for personal use.

### How do I connect Imdbarr to Sonarr?

Deploy it with Docker or Docker Compose and register its endpoint URL as a Custom List in Sonarr. It returns the format Sonarr's Custom List feature expects.

### Can it read public IMDb lists?

Yes, it works with any public IMDb watchlist or list. List IDs start with ls, and lists with 250 or more items are fetched across all pages automatically.

### How do I clear cached TMDB lookups?

Send a POST request to the admin cache clear endpoint. The health endpoint returns health and cache stats.

---
Source: Our Local Host (https://ourlocalhost.com/app/2918/imdbarr), the self-hosted and open-source app directory.
