Home - Nikorag/iplayarr GitHub Wiki

🧠 Welcome to the iPlayarr Wiki

Your personal DVR for BBC iPlayer – built for seamless Sonarr/Radarr integration.


πŸ“š About

iPlayarr is a bridge between the BBC iPlayer and automation tools like Sonarr and Radarr, functioning as both a Newznab-compatible indexer and a SABnzbd-compatible download client.

It uses get_iplayer under the hood to search and download content, allowing fully automated workflows for BBC content without relying on torrents or Usenet.


πŸš€ Key Features

  • πŸ”Ž Search and index iPlayer content through Sonarr/Radarr.
  • ⬇️ Download content automatically using SABnzbd-compatible behavior.
  • πŸ—‚οΈ Handles full media lifecycle: search β†’ download β†’ move.
  • 🧩 Native web interface for settings, logs, and management.
  • πŸ” Secure with API key authentication.
  • 🐳 Docker-ready with built-in Redis (or bring your own).

🧰 Quick Links


🐳 TL;DR: Docker Example

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

🀝 Contributing

Want to improve iPlayarr or file a bug report? Head over to:

πŸ’‘ Why Use iPlayarr?

BBC iPlayer has great content, but limited automation options. iPlayarr makes it easy to search, download, and organize shows and movies using tools you already loveβ€”without sketchy sources or complicated scripts.

🧠 Fun Fact

The name "iPlayarr" is a play on β€œiPlayer” + β€œSonarr/Radarr” β€” merging the best of both worlds.

Ready to dive in? Start with the Installation & Setup page!