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.

GitHub
iplayarr logo

Self-host iplayarr

0.11.6

iPlayer indexer and download client for Sonarr and Radarr

BetaOpen SourceGPL-3.0
Updated6 months ago
LanguageTypescript
Setup difficultyModerate
Stars
142
Port
4404 (Web UI and API for Sonarr/Radarr integration)
Docker
nikorag/iplayarr
Install with Docker
Login view of the iPlayarr web UIQueue view showing active downloadsSearch view for finding iPlayer contentDetails view for a specific item

What is iplayarr?

iPlayarr is a self-hosted bridge that brings BBC iPlayer content into the Sonarr and Radarr automation stack. It functions as a Newznab indexer so shows become searchable inside *arr apps, and as a SABnzbd-compatible downloader so episodes are fetched and post-processed automatically. The backend relies on get_iplayer to pull streams from iPlayer, managing the entire workflow from query to sorted media files. Deployment is via a Docker image that includes a web interface for settings and logs, with Redis bundled for storage. The service listens on port 4404 for API calls from Sonarr and Radarr. Licensed under GPL-3.0.

Should you self-host iplayarr?

iplayarr scores 44/100 on selfhost.directory (how scoring works) and ranks #38 of 45 in Download Management. It has 142 GitHub stars.

It shipped 4 stable releases in the past year. The latest, 0.11.6, came out on 22 April 2026. New versions land roughly every 2 months.

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

Its closest alternative on selfhost.directory is cobalt (83/100, 45 584 stars). It scores higher overall, so compare the two before you pick. See iplayarr vs cobalt side by side.

Features

  • Built-in Authentication
  • Get_iplayer integration
  • Newznab-compatible indexer
  • SABnzbd-compatible download client
  • Web UI

iplayarr README

How to install iplayarr

Install iplayarr with Docker

Environment variables
API_KEY, DOWNLOAD_DIR, COMPLETE_DIR, ACTIVE_LIMIT, REFRESH_SCHEDULE, HIDE_DONATE, PUID, PGID, REDIS_HOST, REDIS_PORT, REDIS_PASSWORD, REDIS_SSL

docker run -d --name iplayarr
-v ./cache:/data
-v ./config:/config
-v ./logs:/logs
-v /path/to/incomplete:/incomplete
-v /path/to/complete:/complete
--env-file=env-file
-p 4404:4404
nikorag/iplayarr:latest

Requires an env-file with configuration

How to configure iplayarr

  • ACTIVE_LIMIT3How many downloads are allowed simultaneously

    How many downloads are allowed simultaneously

  • API_KEYAPI key to secure your iPlayarr instance

    API key to secure your iPlayarr instance

  • COMPLETE_DIRDirectory to move completed files to

    Directory to move completed files to

  • DOWNLOAD_DIRDownload directory for in-progress pulls

    Download directory for in-progress pulls

  • HIDE_DONATEHide the Ko-fi donate links

    Hide the Ko-fi donate links

  • PGIDHost Group ID for file permissions

    Host Group ID for file permissions

  • PUIDHost User ID for file permissions

    Host User ID for file permissions

  • REDIS_HOSTExternal Redis host (optional)

    External Redis host (optional)

  • REDIS_PASSWORDExternal Redis password (optional)

    External Redis password (optional)

  • REDIS_PORTExternal Redis port (optional)

    External Redis port (optional)

  • REDIS_SSLUse SSL for external Redis connection (optional)

    Use SSL for external Redis connection (optional)

    values: true

  • REFRESH_SCHEDULEhourly, on the hourCron expression for when to proactively refresh schedule

    Cron expression for when to proactively refresh schedule

iplayarr releases & version history

More in Download Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…