mdblistarr

Companion app for mdblist.com for better Radarr and Sonarr integration.

Docker Hub image

linaspurinis/mdblistarr

Basics

• Connects MDBList with Radarr and Sonarr.
• Uploads your current library state back to MDBList on schedule.
• Pulls MDBList queue items and sends add requests to Radarr/Sonarr.
• Supports multiple Radarr/Sonarr instances.
• Runs as a simple Docker container with persistent DB volume.

Basic workflow

1. Connect your MDBList account via OAuth (or enter an API key manually).
2. Add your Radarr and Sonarr instances.
3. Set quality profile and root folder mappings per instance.
4. Let scheduled sync keep MDBList and your ARR apps in sync.

New in v2.3.0

• MDBList OAuth authentication: connect your account via the new "Connect with MDBList" button instead of copying an API key. Uses the OAuth 2.0 device authorization flow.
• API key auth still works until you connect via OAuth — once OAuth is connected, the API key is cleared and OAuth takes over.

New in v2.2.4

• Added support for syncing library status across all configured servers

New in v2.2.3

• Optional MDBList collection sync: enable "Sync Library Status" in the MDBList config tab to keep your MDBList collection up to date based on what is downloaded in Radarr/Sonarr.
• Configurable sync hour: choose which UTC hour of the day Radarr and Sonarr sync runs. A random hour is assigned automatically on first run to spread load across all users.
• Home page now shows last sync time and next sync estimate so you always know when to expect the next run.
• Fixed UI bug where the Radarr/Sonarr server form would reset after saving — the selected server now stays active across page reloads.

New in v2.2.2

• Full sync now reports monitored and unmonitored items more reliably:
  • Radarr uses hasFile to mark downloaded vs missing.
  • Sonarr uses episode file statistics where available.
• Import list exclusions from Radarr/Sonarr are included in sync payloads.
• If a movie is already in Radarr, MDBListarr now triggers a Radarr MoviesSearch command instead of only logging a duplicate error.
• HTTP/JSON handling is more defensive for empty/invalid/compressed responses.

App Configuration Screen

MDBListarr

git clone --branch latest git@github.com:linaspurinis/mdblistarr.git
docker build -t mdblistarr .
docker run -e PORT=5353 -p 5353:5353 mdblistarr

services:
  mdblistarr:
    container_name: mdblistarr
    image: linaspurinis/mdblistarr:latest
    environment:
      - PORT=5353
    volumes:
      - db:/usr/src/db/
    ports:
      - '5353:5353'
volumes:
  db: